# Athena

> Local-first memory, decision engine, and governance harness for AI agents — portable across IDEs. Capture what you learn, retrieve it when relevant, evaluate decisions against numeric ruin gates, and carry your context between models. Own the state. Rent the intelligence. MIT Licensed.

Athena is a local-first memory, decision engine, and governance harness that gives any AI model (Gemini, Claude, GPT) permanent memory, 460 reusable decision protocols (426 active + 34 archived across 26 categories; 187 published as examples), 587 case studies, and bounded autonomy — all stored as plain Markdown files on the user's machine. Session 2,100 recalls patterns from session 5.

## Core Documentation

- [README](https://github.com/winstonkoh87/Athena-Public/blob/main/README.md): Full project overview, quickstart, architecture, cost, and changelog
- [Getting Started](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/GETTING_STARTED.md): 6-step installation and first session walkthrough
- [Your First Session](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/YOUR_FIRST_SESSION.md): What to expect when you type /start for the first time
- [Architecture](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/ARCHITECTURE.md): 7-tier compositional stack (Boot → Memory → Reasoning → Skills → Governance → Output → Shutdown)
- [Features](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/FEATURES.md): Complete feature list with examples
- [Spec Sheet](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/SPEC_SHEET.md): Technical specifications and benchmarks

## Search & Memory

- [Semantic Search](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/SEMANTIC_SEARCH.md): Hybrid RAG pipeline (BM25 + pgvector + knowledge graph + RRF fusion)
- [MCP Server](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/MCP_SERVER.md): Model Context Protocol integration for external tool access
- [Memory Bank](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/MEMORY_BANK.md): How persistent context is structured and retrieved
- [Knowledge Graph](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/KNOWLEDGE_GRAPH.md): Entity-relationship graph for cross-session pattern detection

## Guides

- [Compatible IDEs](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/COMPATIBLE_IDES.md): 7 supported editors (VS Code, Cursor, Windsurf, Zoo Code, Cline, Augment, Trae)
- [Workflows](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/WORKFLOWS.md): 77 slash commands (56 root + 21 domain: /start, /end, /plan, /research, /ultrathink, etc.)
- [Best Practices](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/BEST_PRACTICES.md): How to get the most out of Athena
- [Multi-Model Strategy](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/MULTI_MODEL_STRATEGY.md): Using Gemini, Claude, and GPT together
- [FAQ](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/FAQ.md): Frequently asked questions

## Case Studies & Use Cases

- [Case Studies](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/CASE_STUDIES.md): Real-world anonymized examples across therapy, career decisions, research, and business
- [Use Cases](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/USE_CASES.md): Life management, problem solving, decision making, research, trading, academics
- [Top 10 Protocols](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/TOP_10_PROTOCOLS.md): The most impactful decision frameworks

## Philosophy

- [Manifesto](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/MANIFESTO.md): Why sovereign AI matters
- [About Me](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/ABOUT_ME.md): Who built Athena and why
- [User-Driven RSI](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/USER_DRIVEN_RSI.md): How the system evolves through use

## Reference

- [Glossary](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/GLOSSARY.md): Key terms and concepts
- [Changelog](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/CHANGELOG.md): Full version history
- [Security](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/SECURITY.md): Privacy pipeline and data safety
- [References](https://github.com/winstonkoh87/Athena-Public/blob/main/docs/REFERENCES.md): Academic and industry citations
