Interactive Mode

Run athena to start the terminal UI — the primary observability surface for your agent sessions.

Layout

┌──────────────────────────────────────────────────────────────────────┐
│ ATHENA v0.2.3 | ⠙ working        claude-sonnet | tools:7 | ████░ | ● │  ← Header
├──────────────────────────────────────────────────────────────────────┤
│  09:41:02 tool.pre     claude  Read          src/Header.tsx          │
│  09:41:03 tool.post    claude  Read          2.1kb                   │  ← Event feed
│  09:41:05 perm.req     athena  Write         src/Header.tsx → ...    │
├──────────────────────────────────────────────────────────────────────┤
│  input>                                                              │  ← Input bar
└──────────────────────────────────────────────────────────────────────┘

Header — Version, state label (idle / working / waiting for input / error), model name, tool count, context bar (green → amber → red), socket status dot.

Event feed — Every hook event as a row: timestamp, event kind (color-coded), actor, tool name, details.

Input bar — Enter prompts, /slash-commands, :command-mode, or /search.

Event Feed Columns

Column	Description
TIME	`HH:MM:SS` wall clock
EVENT	`tool.pre`, `tool.post`, `tool.failure`, `perm.req`, `perm.decision`, `agent.msg`, etc.
ACTOR	Source (`claude`, `codex`, `athena`). Duplicate adjacent actors shown as `·`
TOOL	Tool name (`Read`, `Write`, `Bash`, MCP tools)
DETAILS	Human-readable summary

Press Enter on a row to expand full details. Navigate with ↑/↓, PageUp/PageDown. Press q or Esc to close.

Search: Press /, type query, n/N to cycle matches, Ctrl+L to clear.

Keyboard Shortcuts

Global

Key	Action
`Ctrl+T`	Toggle todo panel
`Ctrl+/`	Cycle hints bar
`Escape`	Interrupt agent

Feed

Key	Action
`↑`/`↓`	Move cursor
`PageUp`/`PageDown`	Page scroll
`Home`/`End`	Jump top/tail
`Enter` / `Ctrl+→`	Expand/collapse entry
`Tab`	Cycle focus: feed → input → todo
`/`	Search mode
`:`	Command mode

Command Mode (`:` prefix)

Command	Action
`:todo`	Toggle todo panel
`:todo add [p0\|p1\|p2] <text>`	Add todo item
`:run list`	Show run overlay
`:run <needle>`	Filter to matching runs
`:tail`	Jump to tail
`:jump <needle>`	Jump to first match
`:errors`	Toggle errors-only filter

Slash Commands

Command	Aliases	Description
`/help`	`/h`, `/?`	List commands
`/clear`	`/cls`	Clear history
`/quit`	`/q`, `/exit`	Exit
`/stats`	`/s`	Session statistics
`/context`	`/ctx`	Token breakdown
`/sessions`		Session picker
`/tasks`	`/todo`	Task list
`/setup`		Re-run wizard

Themes

Three themes, set via --theme or config:

Theme	For
`dark`	Default. Dark terminal backgrounds.
`light`	Light terminal backgrounds.
`high-contrast`	Accessibility / bright environments.

athena-flow --theme=light

Verbose Mode

athena-flow --verbose

Enables additional detail in feed rows — fuller payloads and context information hidden by default.

ASCII Mode

athena-flow --ascii

Switches all UI glyphs to ASCII-safe equivalents for limited terminals.