The Ecosystem

The Athena ecosystem is built around one idea: the context an agent produces should outlive the session that produced it. Each tool plays a distinct role around that idea.

How the pieces fit together

                        ┌──────────────────┐
   your phone ──────────│  Athena Mobile   │ (PWA over Tailscale)
                        └────────┬─────────┘
                                 │
                        ┌────────▼─────────┐
   your voice ──────────│  Athena Desktop  │── the command room
   (Athena Whisper)     │  Electron + React│   embedded PTY terminals,
                        │  FastAPI backend │   session recall, handoffs,
                        └────────┬─────────┘   Hermes MCP bridge
                                 │
              ┌──────────┬───────┴───────┬───────────┐
              ▼          ▼               ▼           ▼
        Athena Code    Codex        Claude Code   OpenCode
        (memory-first   ...any agent CLI on your PATH...
         coding agent)

• Athena Desktop is the hub. It launches and resumes agent sessions, captures what they did, distills it into bounded handoffs, and keeps project-local recall available to the next agent. It also exposes an MCP bridge so Hermes can drive the workspace itself.
• Athena Code is the ecosystem’s own coding agent. It runs standalone in any terminal, but inside Athena Desktop it’s launched like any other agent pane — and it carries its own persistent memory and cross-session search wherever it runs.
• Athena Loops is the orchestration harness. When one agent isn’t enough, it decomposes a goal into subtasks, fans them out to worker agents (Claude Code, Codex, opencode, aider — any CLI on your PATH), and gates the results through a reviewer that loops until they pass. The control flow is deterministic code, and it’s callable from Python or as an MCP tool by any of the agents above.
• Athena Whisper feeds the whole thing with your voice. It transcribes locally and types the result into whatever has focus: an Athena terminal pane, a coding agent TUI, a browser, anything.
• Athena Mobile (the companion on the wider bench) gives you a window into the same workspace from your phone — session history, terminal launches, and push notifications — without exposing anything to the public internet (it binds to your Tailscale network only).

Shared concepts

A few concepts show up across the ecosystem:

Memory and recall

Durable knowledge lives in memory (long-term facts, preferences, decisions). When a session starts, the relevant slice of memory becomes recall — a bounded, project-local cache the agent reads as background context. Athena Desktop writes recall to <project>/.context-workspace/hermes/session-recall.md; Athena Code keeps its own layered memory under ~/.athena-code/ and <project>/.context-workspace/memory/.

Session handoffs

Instead of pasting a full noisy transcript into a new agent, Athena generates a Session Handoff: a bounded markdown summary extracted from selected sessions, with terminal UI noise filtered out. Save it to recall, then launch a fresh agent that starts informed.

Hermes

Hermes is the long-term memory agent in the stack. Athena Desktop integrates with it in both directions: coding agents can ask Hermes questions through Athena’s backend, and Hermes can drive Athena (spawn terminals, read sessions, write recall) through the MCP bridge.

Repositories

All projects live in public repositories under github.com/luckeyfaraday (Athena Code and Athena Loops are MIT licensed; the others are source-available):

Project	Repository
Athena Desktop	luckeyfaraday/Athena
Athena Code	luckeyfaraday/athena-code
Athena Loops	luckeyfaraday/athena-loops
Athena Whisper	luckeyfaraday/athena-whisper
Athena Mobile	luckeyfaraday/athena-mobile

Project quick starts

These are the first-run commands for each core project. The project-specific pages cover configuration, platform notes, and troubleshooting.

Athena Desktop

git clone https://github.com/luckeyfaraday/Athena.git
cd Athena
python3 -m venv .venv
source .venv/bin/activate
pip install -r backend/requirements.txt
cd client
npm install
npm run dev

Athena Code

curl -fsSL https://raw.githubusercontent.com/luckeyfaraday/athena-code/main/scripts/install.sh | bash
athena-code

On Windows, install with the PowerShell command in Athena Code Installation.

Athena Loops

git clone https://github.com/luckeyfaraday/athena-loops.git
cd athena-loops
python3 -m examples.run_demo        # zero-dependency demo with a mock agent

To drive real coding agents or run the MCP server, see Athena Loops — Getting Started.

Athena Mobile

git clone https://github.com/luckeyfaraday/athena-mobile.git
cd athena-mobile
npm install
npm run dev

This starts demo mode. To connect it to a real Athena Desktop instance, start Athena Desktop first, copy .env.example to .env.local, set VITE_ATHENA_MODE=live, and restart the mobile dev server. For phone access, use the Tailscale flow in Setup & Deployment.

Athena Whisper

git clone https://github.com/luckeyfaraday/athena-whisper.git
cd athena-whisper
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev,gui]"
athena-dictate widget

On Windows, activate the environment with .venv\Scripts\activate and run .venv\Scripts\athena-dictate widget.