Golem Interactive REPL (Go)

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 Go REPL language in Golem. Use the TypeScript REPL (the default) to interact with your Go 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 Go agents. You can get or create agent instances, invoke methods, and see logs streamed during invocations, all with full type safety.

Example: Invoking a Go counter agent from the TypeScript REPL

A Go CounterAgent whose ID is struct{ Name string } is addressed by that name, and its increment / add / value methods are exposed as camelCase client methods:

const c1 = await CounterAgent.get("c1")
await c1.increment()
await c1.add(5)
const value = await c1.value()

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 Go agents.

Run the script after creating it, unless the user explicitly asked not to.

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

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

Prerequisites

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

Related Guides