Quick Start

Quick Start

Start Athena in Your Project

Navigate to your project directory and run:

cd /your/project
athena

On first run, the Setup Wizard launches automatically to configure your theme, harness, and optional workflow.

After setup, Athena registers its hooks with Claude Code and opens the live terminal UI. Start a Claude Code session in another terminal — Athena will pick up all events automatically.

Common Launch Patterns

Start in a specific project directory:

athena-flow --project-dir=/path/to/project

Resume the most recent session:

athena-flow resume

Resume a specific session by ID:

athena-flow resume <session-uuid>

Pick a session interactively:

athena-flow sessions

Run non-interactively (CI/script mode):

athena-flow exec "run all tests"

Start with a workflow active:

athena-flow --workflow=e2e-test-builder

Change isolation level:

athena-flow --isolation=permissive

Use ASCII-safe glyphs (for limited terminals):

athena-flow --ascii

Re-run the setup wizard:

athena-flow setup

What You'll See

Once Athena is running, the header shows session state and the event feed streams tool calls as they happen:

ATHENA v0.2.3 | ⠙ working              claude-sonnet-4-5 | tools:12 | ████░░░░░ | ●

Each row in the feed is a discrete event from Claude Code's runtime — tool calls, results, permission prompts, agent messages, and session lifecycle events. See the Terminal UI section for a full breakdown.

Next Steps