Skip to content

recursive repl

Interactive REPL — one goal per line.

bash
recursive repl [OPTIONS]

Description

Starts an interactive session where each line you type is treated as a new goal. The agent runs to completion, prints the result, then waits for the next goal.

Session state (transcript, memory) is preserved across goals within the same REPL session.

Options

OptionDefaultDescription
--workspace <path>cwdFilesystem sandbox root
--max-steps <n>32Step budget per goal
--session <id>(new)Resume an existing session

REPL commands

CommandDescription
:q or :quitExit the REPL
:clearClear the transcript (start fresh)
:sessionPrint the current session ID
:toolsList available tools

Example

$ recursive repl
Recursive REPL — type a goal, :q to exit
> list the files in src/
[tool: list_dir] ...
The src/ directory contains: agent.rs, lib.rs, tools/, llm/, ...

> explain what agent.rs does
[tool: read_file] ...
agent.rs implements the ReAct loop. It alternates between...

> :q
Goodbye.

Released under the MIT License.