CLI Reference
Commands
athena-flow / athena
Start the Athena runtime with the terminal UI.
athena-flow [options]athena-flow setup
Re-run the setup wizard (theme, harness, workflow).
athena-flow setupathena-flow sessions
Interactive session picker.
athena-flow sessionsathena-flow resume
Resume a previous session.
athena-flow resume # most recent
athena-flow resume <session-id> # specific sessionathena-flow exec
Non-interactive mode for CI and scripts.
athena-flow exec "<prompt>" [options]athena workflow install
Install a workflow from a marketplace.
athena workflow install <ref> --name <local-name>Flags — General
| Flag | Description | Default |
|---|---|---|
--project-dir=<path> | Project directory | cwd |
--plugin=<path> | Load plugin directory (repeatable) | — |
--isolation=<preset> | strict / minimal / permissive | strict |
--theme=<theme> | dark / light / high-contrast | dark |
--workflow=<name> | Activate installed workflow | — |
--verbose | Extra detail in event feed | off |
--ascii | ASCII-safe glyphs | off |
Flags — Exec Mode Only
| Flag | Description | Default |
|---|---|---|
--json | JSONL events to stdout | off |
--output-last-message=<path> | Write final message to file | — |
--ephemeral | No session persistence | off |
--on-permission=<policy> | allow / deny / fail | fail |
--on-question=<policy> | empty / fail | fail |
--timeout-ms=<ms> | Hard timeout | — |
--continue[=<id>] | Resume session | — |
Exit Codes (exec mode)
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Permission request with fail policy |
| 3 | Question with fail policy |
| 4 | Timeout exceeded |
| 5 | Agent error |
| 6 | Session not found |
| 7 | Hook registration failure |
In-Session 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 |
Plugin skills with user-invocable: true also appear as slash commands.
Isolation Presets
| Preset | MCP Servers | Allowed Tools |
|---|---|---|
strict | Blocked | Read, Edit, Glob, Grep, Bash, Write |
minimal | Project servers | Above + WebSearch, WebFetch, Task, Skill, mcp__* |
permissive | Project servers | Above + NotebookEdit |