OpenParable
Skip to content
← Back to skills

Golem Interactive Repl Scala

Testing & Quality
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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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

LanguageFlagInteractiveScriptNotes
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)