docs / cli reference

CLI reference

One binary, a handful of subcommands, and a chat surface that covers the rest. Everything here is quoted from main, not from memory.

Commands

command	what it does
`wombat`	open the chat UI (new UI when built, classic otherwise)
`wombat classic`	force the classic TUI
`wombat chat`	open the chat (alias of the default command)
`wombat run "<task>"`	run one task and exit
`wombat run -c "<task>"`	continue the latest session
`wombat resume [id\|last]`	reopen a session in either UI
`wombat sessions`	list sessions for this directory
`wombat setup`	choose provider, key and model
`wombat models [provider]`	list models the provider reports
`wombat doctor`	diagnose config, permissions and connectivity
`wombat config`	print config with keys redacted
`wombat config set <key> <value>`	change one setting
`wombat mcp add\|list\|test\|import`	attach and check MCP servers
`wombat mcp login\|logout\|enable\|disable\|remove`	manage servers
`wombat agent new\|list`	scaffold and list custom agents
`wombat checkpoint list\|restore`	shadow-git snapshots
`wombat upgrade`	install the latest tagged release
`wombat version`	print the version

wombat run is the scriptable path: it exits when the task is done, streams nothing extra with --quiet, and never stops mid-build to ask a question.

Run flags

flag	meaning
`-m <model>`	model override for this run
`-p <provider>`	provider override
`--yolo`	auto-approve tool permissions
`-c`	continue the latest session
`--quiet`	print assistant text only
`--profile <name>`	auto, minimal, coding, web, semantic, verify, media, orchestrator, full
`--research <mode>`	auto, off, quick, standard, deep
`--agents a,b`	custom agents for this run
`-i, --image <path>`	attach an image (repeatable)
`--file, --video, --audio`	attach other media

Inside the chat

group	commands
session	`/new · /compact · /clear · /history · /sessions · /copy [n\|all] · /exit`
models	`/model · /configure · /providers · /models · /reasoning`
context	`/status · /cost · /usage · /todos · /sources · /reference add\|rm\|clear`
tools	`/toolset · /agents · /mcp · /preview [n] · /previews · /imagen · /skill`
appearance	`/theme · /mouse · /thinking · /keys · /help`
safety	`/mode · /modes · /yolo · /doctor · /setup`

/help (or /keys) prints the same list with the key map. The command palette opens on / and filters as you type.

Keys

enter / shift+entersend / new line
escstop the run, close an overlay
/command palette
@file picker with tab completion
ctrl+oopen the newest preview
ctrl+g or ?help and key map
ctrl+tcycle themes
ctrl+p / ctrl+nprompt history
ctrl+rproject references
ctrl+ycopy the last reply
alt+2/3/4/5sessions, models, usage, doctor
pgup / pgdnscroll the transcript

The classic interface has its own map: run /help there. Mouse wheel scrolling replaces text selection while mouse is on; turn it off to select and copy with the terminal instead.

Sessions

A session is a JSONL transcript, scoped to the directory you started in and stored under ~/.wombat/sessions/<project-hash>/. Tool calls, prompts and model usage are recorded alongside the messages, which is what /sources and /cost read.

wombat sessions
wombat resume last
wombat run -c "keep going"
wombat checkpoint list
wombat checkpoint restore <id>

Checkpoints are a private shadow git repository next to the session. They are on by default; wombat config set checkpoints false turns them off. restore takes --yes and --session flags when you are scripting it.

Themes

Fifteen palettes ship in the binary. /theme opens the live picker, ctrl+t cycles, and the choice is saved to the config.

wombat · tokyo · catppuccin · gruvbox · nord · rosepine · dracula · everforest · kanagawa · solarized · monokai · iceberg · nightfox · onedark · github

The classic interface still tints the terminal background while Wombat runs and restores it on exit; wombat config set paint_background false disables that.