Setup Wizard

The setup wizard runs automatically on first launch. It walks through three steps: visual theme, harness selection, and optional workflow activation. Choices are saved to your global config at ~/.config/athena/config.json.

Re-run it at any time with:

athena-flow setup

Step 1: Theme Selection

Choose the color theme for the terminal UI:

Theme	Description
`dark`	Default. High-contrast colors on dark terminal backgrounds.
`light`	Optimized for terminals with light backgrounds.
`high-contrast`	Maximum contrast for accessibility or bright environments.

The theme can also be changed later via the --theme flag or in your config file.

Step 2: Harness Selection

Select the agent harness Athena will wrap. Currently available:

Harness	Status
`claude-code`	Production
`openai-codex`	Coming soon
`opencode`	Coming soon

The wizard detects whether Claude Code is installed. If it isn't found, you'll be prompted to install it before continuing.

Step 3: Workflow Activation (Optional)

The wizard offers to activate a workflow for your sessions. Workflows define how Athena orchestrates Claude Code for a specific task category — for example, e2e-test-builder for automated test generation.

You can skip this step and activate workflows later via the --workflow flag or by adding a workflow key to your config.

Resulting Configuration

After completing the wizard, the global config at ~/.config/athena/config.json is updated with your choices. You can inspect and edit this file directly — the wizard is a convenience layer over the config schema. See Configuration for all available fields.