Athena Flow CLI

Athena Flow is a workflow runtime for AI coding agents. It wraps Claude Code and OpenAI Codex, normalizing their event streams into a unified runtime with structured workflows, real-time observability, session persistence, and a plugin system.

Mental Model

Five concepts, layered:

Harness → Runtime → Workflow → Plugin → Hook

• Harness — The agent runtime Athena wraps (Claude Code or OpenAI Codex)
• Runtime — Athena's core: receives events over UDS/JSON-RPC, persists to SQLite, renders UI
• Workflow — Reusable session definition: prompt + plugins + loop config + isolation
• Plugin — Directory adding skills (slash commands) and MCP servers
• Hook — Lifecycle event from the agent runtime (tool use, permissions, session start, etc.)

Quick Start