Usage

Interactive terminal UI

Start the interactive terminal UI in the current project:

athena-code

One-shot tasks

Run a one-shot coding task:

athena-code run "explain this repository and identify the highest-risk module"

Memory commands

Save and inspect durable memories:

athena-code memory add "Use pnpm for this organization"
athena-code memory list

Resume a session

athena-code --session SESSION_ID

Use athena-code --help for the complete command reference.

Inside Athena Desktop

Athena Code is a standalone CLI, but Athena Desktop treats it exactly like Codex, OpenCode, and Claude Code: the Command Room launches it from the New menu as a regular embedded PTY (including a grid mode for parallel panes), it must be on PATH, and it participates in the same clean/task/curated/immersive context modes as every other agent.

Development

Run the focused test suite:

npx --yes bun@1.3.14 test test

Build the complete executable:

./scripts/build.sh

See CONTRIBUTING.md for the development workflow and pull request expectations.