Quick Start: init → open → connect

Step 1: Initialize Athena

Navigate to your project root and execute athena init:

bash

cd /path/to/your/project
athena init

Athena will scan repository manifests, schema files, routers, and git history, writing 11 generated markdown documents plus your rules.md into a newly created .athena/ folder.

Step 2: Open the Local Web UI

Launch the local web dashboard to inspect the generated knowledge:

bash

athena open

Athena listens on 127.0.0.1, port 7432 by default (or the next free port if 7432 is busy), and opens http://127.0.0.1:7432/#token=…. The token is in the URL fragment (after #), so browsers never send it in requests or Referer headers. You can review detected entities, edit project rules, or test context tasks.

Step 3: Connect an AI Coding Agent

Configure your preferred AI assistant:

bash

# Claude Code, Cursor, Codex, GitHub Copilot or Gemini CLI:
athena agents add claude-code   # or: cursor, codex, copilot, gemini-cli

# Antigravity, Windsurf or Cline:
athena agents add antigravity   # or: windsurf, cline

# Any agent that reads AGENTS.md:
athena agents add agents-md

athena init already configures the agents it detects in your project, plus AGENTS.md. Run athena agents to see what's configured.