Skip to content

CLI Overview

The recursive binary provides several subcommands:

CommandDescription
runExecute a single goal and exit
replInteractive REPL — one goal per line
loopSelf-scheduling autonomous loop mode
httpStart the HTTP API server
toolsList registered tools (no API key needed)
sessionsManage persisted sessions

Installation

bash
cargo install recursive-agent

Global flags

FlagDefaultDescription
--workspace <path>cwdFilesystem sandbox root
--max-steps <n>32Step budget per run
--model <name>gpt-4o-miniOverride model
--api-base <url>https://api.openai.com/v1Override endpoint
--provider <name>defaultNamed provider profile from providers.toml
-v / --verboseoffVerbose output

Released under the MIT License.