Athena

A project-aware, capability-driven advisory framework for AI coding assistants.

Athena is an AI Consultation Runtime. Cursor Composer owns execution; Athena owns consultation.

Features

• Single MCP tool: consult(advisor_type, question, session_context, mode)
• Capability-driven routing across Anthropic, OpenAI, and Ollama providers
• Project memory with SQLite storage and git-based incremental indexing
• Structured advisory responses for Composer to apply

Quickstart

pip install -e ".[dev,providers]"
export ANTHROPIC_API_KEY=your-key
python -m athena.mcp_server.server

Add the plugin MCP config from plugin/.mcp.json to your project's .cursor/mcp.json.

Documentation

Engineering specifications live in docs/specs/README.md.

Development

pip install -e ".[dev,providers]"
python3 -m pytest -q
python3 -m ruff check athena tests benchmarks
python3 benchmarks/run_baseline.py

See docs/extension-guide.md for adding providers, advisor profiles, capabilities, and strategy modes.

License

MIT — see LICENSE.