Skip to content

CLI

atomic-agent ships a terminal UI (TUI) built on Ink. It’s a real operator surface, not a chat window.

Launch

Terminal window
# default
atomic-agent
# terminal UI, scoped to a working directory
atomic-agent tui --cwd /path/to/work

The TUI at a glance

The header shows the version and three modes — Run · Observe · Manage. A status bar at the bottom reports health, latency, the active model, and the provider (for example: ● healthy · 2 ms · qwen-3.5-9b · llama.cpp). A side panel tracks your Sessions and Tasks.

Keyboard shortcuts

KeyAction
EnterSubmit message to the agent
Alt+EnterNew line
/helpList all slash commands
/sessionsSwitch to a previous thread
/newStart a fresh session
/observe · /manage · /runOperator dashboards (Tab cycles panels in debug)
TabToggle sidebar
Ctrl+C ×2Quit (once aborts a running turn)

See the full list under Reference → CLI Commands.