# Golem Interactive Repl Scala

> Golem Interactive Repl Scala is an Agent Skill for testing & quality published in the golemcloud/golem repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Using the Golem REPL for interactive testing and scripting of agents. Use when asked to test agents interactively, run a REPL, or execute test scripts against deployed agents.

- Skill name: `golem-interactive-repl-scala`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/golemcloud/golem/blob/HEAD/golem-skills/skills/scala/golem-interactive-repl-scala/SKILL.md
- Repository: golemcloud/golem (1,605 GitHub stars when collected)

## SKILL.md

# Golem Interactive REPL (Scala)

The `golem repl` command starts an interactive REPL for testing and scripting agents. It supports both an **interactive mode** and a **script execution mode**.

**There is no Scala REPL language** in Golem. Use the **TypeScript REPL** (the default) to interact with your Scala agents — all agent types are available as TypeScript classes regardless of the agent's source language.

## Interactive Mode

```shell
golem repl
```

Starts a TypeScript REPL with all agent client classes preconfigured in the global scope — including your Scala agents. You can get or create agent instances, invoke methods, and see logs streamed during invocations, all with full type safety.

### Example: Invoking a Scala counter agent from the TypeScript REPL

```typescript
const c1 = await CounterAgent.get("c1")
await c1.increment()
await c1.increment()
const value = await c1.getValue()
```

### Built-in Commands

The REPL provides built-in commands that mirror CLI functionality. Commands accept both `.` and `:` prefixes:

- `.build` / `:build` — build the project
- `.deploy` / `:deploy` — deploy components
- `.help` / `:help` — show available commands

This lets you build, deploy, and test agents without leaving the REPL.

## Script Mode

Run a TypeScript file non-interactively:

```shell
golem repl --script-file test.ts --yes
```

The `--yes` flag auto-confirms any prompts. The script has the same global scope as the interactive REPL — all agent client classes are available, including Scala agents.

### Example script (`test.ts`)

```typescript
const c2 = await CounterAgent.get("c2")
await c2.increment()
await c2.increment()
```

Run it:

```shell
golem repl --script-file test.ts --yes
```

## Available REPL Languages

| Language | Flag | Interactive | Script | Notes |
|----------|------|-------------|--------|-------|
| TypeScript | (default) | ✅ | ✅ | The only REPL — works with all agent languages |

No Scala REPL is available yet. The TypeScript REPL is recommended for interacting with Scala agents.

## Prerequisites

- The Golem server must be running (`golem server run`)
- Components must be deployed (`golem deploy`)

---

Source: https://www.openparable.com/skill/testing-quality/golem-interactive-repl-scala (OpenParable). Cite the canonical URL above.
