CLI overview

A terminal-native agent interface built in Rust.

Optamus CLI is a full-screen terminal interface for agent work. It is a single static binary — no Node or Electron — and it runs the same agent core as the other Optamus surfaces.

The CLI is in development. Request early access from the download page.

Launch

cd ~/code/my-project
optamus

The TUI opens with the workspace in the header and a composer at the bottom.

Keys

KeyAction
EnterSend a message or run a /command
Alt+EnterInsert a newline
EscCancel the stream, close a popup, or clear the input
Up / DownScroll the transcript or move the palette highlight
TabOpen the command palette (empty input)
F1Help overlay
F2Swap the color palette
Ctrl+CQuit

Commands

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

Flags

FlagMeaning
--continueResume the latest session
--engine mockRun the offline demo engine
--engine claude-rawUse the live Claude backend

Sessions are appended to ~/.optamus/sessions as JSONL. Next: CLI command reference.