CLI Reference
Options
Section titled “Options”--cwd <path>: working directory for context loading and display.--model <name>: completion model.--websearch <duckduckgo|searxng|none>: application-owned web-search backend.--websearch-url <url>: SearXNG HTTP(S) base URL whensearxngis selected.--verbose: show diagnostic transcript rows such as provider events and log paths.--theme <eldritch-minimal|iceberg-dark|catppuccin-mocha>: UI color theme.--mouse: enable terminal mouse capture for overlay mouse events.--print-prompt: print the assembled prompt bundle and exit without calling the provider.
Commands
Section titled “Commands”thndrs setup [--provider <umans|opencode-go|opencode-zen|chatgpt-codex>]: choose a provider, verify or establish its credential, and apply that provider’s initial model when writing a config file. API-key providers use hidden key entry;chatgpt-codexuses ChatGPT OAuth. Use/model,--model, or configuration to select another model.thndrs setup --global: prefer the user config and credential store.thndrs setup --project: prefer the workspace config and credential store.thndrs login <provider>: replace or renew a provider credential. API-key providers use hidden input and explicit confirmation.thndrs logout <provider>: remove the selected provider’s stored credential.thndrs auth status: show provider credential sources without values.thndrs doctor: print redacted human-readable setup diagnostics.thndrs doctor --json: print redacted machine-readable diagnostics for bug reports.thndrs skills doctor: show duplicate skill names, the selected path, and ignored paths.thndrs config path: print global and project config paths.thndrs config show --redacted: print effective config, origins, loaded files, and diagnostics.thndrs config edit --global: open the global config file with$EDITOR.thndrs config edit --project: open the project config file with$EDITOR.thndrs login chatgpt-codex [--oauth-method <browser|device-code>]: log in through ChatGPT OAuth.thndrs logout chatgpt-codex: remove the stored ChatGPT Codex credential entry.
Inside the TUI, /context inspects the active context working set and
/doctor reports context source, pin, budget, and compaction review health.
Use /context pin <id-or-path>, /context drop <id>, /context recover <id>,
and /context review <approve|reject> for task-local context control.
Supported API-key setup and login providers include umans, opencode-go, and
opencode-zen. ChatGPT Codex setup and login share the ChatGPT-backed OAuth
flow and store refreshable credentials in ~/.thndrs/auth.json, not in
.thndrs/credentials.env.
ACP (Agent Context Protocol)
Section titled “ACP (Agent Context Protocol)”ACP agents are selected in the TUI with --model acp:<name>. They are
configured under [acp_agents.<name>].
thndrs acp list: list configured ACP agents.thndrs acp inspect <name>: show one configured ACP agent with command values redacted.thndrs acp smoke <name> --prompt <text>: initialize an ACP agent, create a temporary session, send one prompt, and print streamed events.thndrs acp logout <name>: call agent-owned logout when advertised.thndrs acp list-sessions <name>: list external sessions owned by an ACP agent when it advertisessession/list.thndrs acp load-session <name> <session-id>: load an external ACP session and print replayedsession/updateevents.thndrs acp resume-session <name> <session-id>: resume an external ACP session without replaying history.thndrs acp close-session <name> <session-id>: close an external ACP session when the agent advertisessession/close.thndrs acp registry [--file <path>]: list agents from the read-only official ACP Registry metadata without installing them.thndrs acp install <registry-id> [--name <name>] [--file <path>] --yes: add a supported registry agent to workspace ACP config and installed-agent metadata.thndrs acp update <name> [--file <path>] --yes: update a registry-managed ACP agent in workspace ACP config and installed-agent metadata.
For more information see ACP.
ACP Agent Server
Section titled “ACP Agent Server”thndrs acp serve exposes thndrs as an ACP stdio agent for editors and IDEs.
stdout is protocol-only; diagnostics go to stderr.
thndrs --cwd <path> acp serve: start the ACP server for a workspace.--model <model>: provider model for new sessions.--websearch <duckduckgo|searxng|none>: application-owned web-search backend.--websearch-url <url>: SearXNG HTTP(S) base URL.--session-dir <path>: append-only local session JSONL directory.
MCP (Model Context Protocol)
Section titled “MCP (Model Context Protocol)”thndrs mcp list: list configured MCP servers as<server>\t<enabled|disabled>\t<transport>and print config diagnostics.thndrs mcp test <name>: initialize one server and print<server>\tready\t<N> tools, followed by startup diagnostics.thndrs mcp tools <name>: list provider-visible namespaced tools from one server as<mcp__server__tool>\t<description>.thndrs mcp call <server> <tool> --json <args>: call one original MCP tool name with JSON object arguments and print capped tool output lines.
The <tool> argument for mcp call is the original MCP tool name reported by
the server. Provider-facing names are namespaced as mcp__{server}__{tool}.
Session History & Management
Section titled “Session History & Management”thndrs sessions list: list local sessions newest first.thndrs sessions show <id>: print the replayable transcript.thndrs sessions resume <id>: validate and exclusively lock a local session for append-only continuation.thndrs sessions inspect <id> --format json: print the stable redacted JSON session projection.thndrs sessions export <id> --format jsonl: write redacted JSONL records in sequence order.
session is accepted as an alias for sessions. <id> may be exact or a
unique prefix; ambiguous prefixes are rejected. All commands use --cwd to
find the workspace session directory unless --session-dir is supplied.
Debugging
Section titled “Debugging”thndrs debug tail [--lines <count>]: read the newest bounded, redacted daily log.thndrs debug session-log <id> [--lines <count>]: read a bounded, redacted per-session log.