CLI Reference

This page is grounded in crates/cli/src/cli.rs.

Binary

swarmie [COMMAND]

If no command is provided, Swarmie starts the interactive REPL.

Run Swarmie non-interactively.

swarmie prompt [PROMPT]

PROMPT behavior:

Options:

Flag	Type	Description
`-c`, `--config <key=value>`	repeatable string	Override config value (dotted path supported, value parsed as TOML when possible).
`-m`, `--model <MODEL>`	string	Model to use.
`--provider <PROVIDER>`	string	Provider to use.
`-p`, `--profile <CONFIG_PROFILE>`	string	Config profile from `config.toml`.
`--dangerously-bypass-approvals`	bool	Bypass approval prompts in non-interactive runs.
`-C`, `--cd <DIR>`	path	Working directory root for the agent.
`--json`	bool	Print events to stdout as JSONL.

Examples:

swarmie prompt "Summarize this repo"
swarmie prompt -m sonnet -p work
cat prompt.txt | swarmie prompt -
swarmie prompt "Explain src" --json

Resume an interactive session.

swarmie resume [--last]

Options:

Flag	Type	Description
`--last`	bool	Continue most recent session for current workspace.

Start HTTP server and open web interface.

swarmie web [OPTIONS]

Options:

Flag	Type	Default	Description
`--port <PORT>`	`u16`	`4200`	Port to listen on.
`--hostname <HOSTNAME>`	string	`127.0.0.1`	Hostname/interface to bind.
`--password <PASSWORD>`	string	none	Server password (prefer `SWARMIE_SERVER_PASSWORD`).
`--cors <ORIGIN>`	repeatable string	none	Additional CORS origins.
`--no-open`	bool	false	Do not open browser automatically.

swarmie web resolves password from --password first, then SWARMIE_SERVER_PASSWORD.
swarmie prompt exits non-zero on startup/runtime failures and auto-denies permissions unless bypass is set.