Golem Interactive Repl Scala
Testing & Qualitygolem-interactive-repl-scalaGolem 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/golemcloud/golem/blob/HEAD/golem-skills/skills/scala/golem-interactive-repl-scala/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/golem-interactive-repl-scala, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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
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
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:
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)
const c2 = await CounterAgent.get("c2")
await c2.increment()
await c2.increment()
Run it:
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)