CLI Flags

Run caboose --help to see all available options. Flags override values set in config files.

Flag reference

caboose [OPTIONS]

Flag	Short	Value	Default	Description
--prompt	-p	<PROMPT>	(interactive)	Run a single prompt non-interactively and exit.
--model	-m	<MODEL>	Config value	Model to use, e.g. claude-sonnet-4, gpt-4.1.
--provider		<PROVIDER>	Config value	Provider to use: anthropic, openai, gemini, ollama.
--session	-s	<SESSION>	(new session)	Resume a previous session by its ID.
--cwd	-d	<CWD>	Current directory	Set the working directory for the session.
--mode		<MODE>	default	Permission mode. See below.
--debug			false	Enable debug logging to stderr.
--help	-h			Print help and exit.
--version	-V			Print version and exit.

Permission modes

The --mode flag accepts one of:

Mode	Behavior
plan	Agent reasons and responds but never executes tools.
default	Agent prompts for approval before each tool call.
auto-edit	File edits are auto-approved; destructive tools still prompt.
chug	All tools auto-approved. Use with caution.

Subcommands

Subcommand	Description
caboose daemon start	Start the background daemon for persistent circuits.
caboose daemon stop	Stop the running daemon.
caboose daemon status	Show whether the daemon is running and its PID.
caboose update	Self-update to the latest release, detecting your install method.

Usage examples

Non-interactive single prompt — run a task and exit:

caboose -p "Add error handling to src/main.rs"

Specify a model and provider on the fly:

caboose -m gpt-4.1 --provider openai

Resume a previous session to continue where you left off:

caboose -s abc123

Run in a different directory without changing your shell’s cwd:

caboose -d /path/to/project

Full auto mode for scripting or batch operations:

caboose -p "Run the test suite and fix any failures" --mode chug