Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Coming soon: a skills repository, business use cases, and more guides.
Reference for the loop command-line interface.
loop [OPTIONS] [COMMAND]
--print, Loop starts the interactive TUI.
| Flag | Short | Description |
|---|---|---|
--cwd <PATH> | Working directory (default: current directory) | |
--provider <ID> | Provider id. Requires --model | |
--model <ID> | Model id, or provider/id. A bare id must be unique across providers | |
--theme <NAME> | UI theme | |
--system-prompt <TEXT> | Replace the system prompt | |
--append-system-prompt <TEXT> | Append text to the system prompt | |
--no-context-files | -c | Skip AGENTS.md / CLAUDE.md |
--resume <ID> | Resume a session by id | |
--print <PROMPT> | Run one prompt and print the answer | |
--debug | Write session logs under cwd/target/debug/logs (also LOOP_DEBUG=1) |
/model, or asks you to pick one.
| Flag | Default | Description |
|---|---|---|
--serve-mcp | off | Listen as a streamable-HTTP MCP server instead of starting the TUI |
--mcp-host <ADDR> | 127.0.0.1 | Listen address. A non-loopback address requires --mcp-token |
--mcp-port <PORT> | 3100 | Listen port |
--mcp-token <TOKEN> | Require Authorization: Bearer <token>. Required when --mcp-host is not loopback |
telemetry feature)--print. Present only in a --features telemetry build. See Tracing.
| Flag | Description |
|---|---|
--trace-name <NAME> | Trace name (default loop.print) |
--trace-tag <TAG> | Tag; repeatable |
--trace-metadata <key=value> | Metadata; repeatable |
--trace-session <ID> | Langfuse session id |
--trace-env <ENV> | Environment label |
--trace-parent <TRACEPARENT> | Parent W3C traceparent (or TRACEPARENT) |
loop configagent dir: /Users/you/.loop/agent
settings: /Users/you/.loop/agent/settings.json
auth: /Users/you/.loop/agent/auth.json
models store: /Users/you/.loop/agent/models-store.json
sessions db: /Users/you/.loop/agent/sessions.db
loop versionloop --version).
loop
loop --cwd /path/to/project
loop --provider soket --model qwen3-30b
loop --provider openrouter --model anthropic/claude-sonnet-4
loop --theme light
loop --print "explain this codebase"
loop --model soket/qwen3-30b --print "review src/main.rs"
loop --system-prompt "You are a security reviewer" --print "audit this code"
loop --resume abc123 --print "continue and run the tests"
loop --resume abc123def
loop --no-context-files
loop --debug
loop --serve-mcp
loop --serve-mcp --mcp-port 8080 --mcp-token my-secret
loop --serve-mcp --mcp-host 0.0.0.0 --mcp-token my-secret
| Code | Meaning |
|---|---|
0 | Success |
1 | Error (bad arguments, missing provider, API failure, and similar) |