CLI commands

Command and flag reference for the Optamus CLI.

The CLI is launched with optamus and is driven from the terminal UI. Its commands are slash commands typed into the composer.

Slash commands

CommandDescription
/demoReplay the streaming demo
/engineSwitch the active agent engine
/themeSwap the color palette
/clearClear the transcript
/helpShow the help overlay
/quitQuit

Launch flags

optamus [--continue] [--engine <kind>]
FlagTypeDescription
--continuebooleanResume the latest session
--engine <kind>mock | claude-raw | harnessSelect the agent engine

Keyboard

Enter sends, Alt+Enter inserts a newline, Esc cancels, Tab opens the palette, F1 shows help, F2 swaps the palette, and Ctrl+C quits.

Sessions

Transcripts are appended to ~/.optamus/sessions/<day>.jsonl. TUI settings live in ~/.config/optamus/tui.toml; set OPTAMUS_TUI_CONFIG to use a different path.