Project Athena
The Linux OS for AI Agents.
Persistent memory, structured reasoning, and governed autonomy for any LLM — across ChatGPT, Claude, Gemini, and any model you switch to next.
Own the state. Rent the intelligence. Platforms forget. Athena doesn't.
Quickstart · How It Works · Validation Status · Docs · FAQ · Safety · Contributing
Last updated: 5 Jul 2026
The Problem
You've spent months training ChatGPT to understand you. Then a model update resets the personality. Your custom instructions stop working. You can't find that conversation from last Tuesday. And if you switch to Claude or Gemini? You start from zero.
Platform memory is unreliable, opaque, and locked to one provider. You don't own it, you can't inspect it, and you can't take it with you.
Why Athena?
Athena moves the memory layer to your machine. Plain Markdown files that you own, version-control, and point at any model.
- 🧠 Your Memory, Your Machine — Files on your disk, not in OpenAI's cloud. Read them, edit them, git-version them.
- 🔌 Switch Models Freely — Claude today, Gemini tomorrow, GPT next week. The memory stays. The model is just whoever's on shift.
- 📈 It Compounds — Session 500 recalls patterns from session 5. Platform memory decays; Athena's doesn't. The moat isn't the code — it's your data. Anyone can fork Athena; nobody can fork your sessions. → The Compounding Effect
- ⚡ 2K–20K Token Boot — Scales to the task. Lightweight chat (~2K) →
/start(~10K) →/ultrastart(~20K). 80–98% of your context window stays free, even after 10,000 sessions. - 🔬 Meta-Game Reasoning — Generic LLMs optimise within the game you're playing. Athena asks whether you should be playing that game at all. → Meta-Game Thesis
- 🛡️ Governed Autonomy — 6 constitutional laws, 4 capability levels, bounded agency.
A generic LLM is a brilliant amnesiac. Athena is the hippocampus — the memory that makes intelligence useful.
Or in engineering terms: The LLM is the engine. Athena is the chassis, the memory, and the rules of the road. Swap the engine anytime — the car remembers every road you've driven.
The design philosophy: augment the human, not replace them. After 1,900+ sessions, the bottleneck shifted — optimising the operator is now higher-leverage than optimising the AI.
The Human Augmentation Thesis
Athena's centralised design principle: augment human cognition, not replace it. The more context you give Athena, the sharper its answers become — not by remembering your preferences, but by reasoning differently because of what it knows about you.
A generic LLM gives the internet's statistically average answer — correct on average, across all humans. Athena gives answers calibrated to your specific situation, because statistical correctness and personal correctness are completely different things:
Generic LLMs solve the question. Athena solves the person. The same question, asked by different people with different lives, demands fundamentally different answers. A generic LLM can’t differentiate because it has no context. Athena can’t give the same answer twice — because the context files are different. The memory is the product.
What Athena Actually Does With Your Problem
Not all problems are solvable. Athena classifies and responds accordingly:
| Problem Type | What Athena Does | Example |
|---|---|---|
| Solvable | Solves it | "What's the Kelly fraction for this bet?" → calculates, answers |
| Optimisable | Optimises within your chosen path | "I've decided to freelance — help me price it" → constraint optimization |
| Unsolvable | Maps every option, prices every trade-off, hands the choice back to you | A closeted husband with children weighing whether to stay married or come out — no clean answer exists. Children, shared assets, identity, cultural context, and personal wellbeing all pull in different directions. Athena ensures you choose with full information, not comfortable illusions |
| Ruin-path | Vetoes before you walk off the cliff | "This bet risks everything" → Law #1 override, regardless of your preference |
The uncertainty of the domain changes Athena's conviction level:
| Domain Type | Athena's Posture | What Athena Provides | Example |
|---|---|---|---|
| Deterministic | High conviction — single correct answer exists | The answer | Code bugs, math proofs, tax calculations |
| Semi-deterministic | Moderate conviction — answer depends on assumptions you control | The answer ± narrow band + stated assumptions | Sentencing prediction, medical prognosis, fitness timelines |
| Semi-stochastic | Low conviction — structural edge exists but randomness dominates | Everything except the answer — setup, sizing, risk, invalidation | Trading setups, poker, card counting, market timing |
| Stochastic | Minimal conviction — no model outperforms randomness reliably | Honest refusal — no edge exists | Lottery numbers, startup outcomes, long-term predictions |
As uncertainty increases, Athena shifts from "here's the answer" to "here's the valid structural zone" to "here are your options — you choose." This is deliberate: false confidence in stochastic domains is more dangerous than honest uncertainty. Athena's conviction is proportional to domain determinism and context completeness.
Crucially, conviction and decisiveness are independent axes. Low certainty about outcomes doesn't require vague output. A poker professional shoves all-in with pocket aces — maximum decisiveness — while knowing they'll lose ~20% of the time. The decision is structurally correct; the outcome is genuinely random. In semi-stochastic domains, Athena delivers precise, operational setups — then explicitly defers the probability judgment to you. "Setup: Long 1.0850 / SL 1.0800 / TP1 1.0920. Your calibration: structural tell present Y/N?" — not "you might want to consider..." — Protocol 524 →
Law #0 (Sovereignty): Your life, your weights, your choice. Law #1 (No Irreversible Ruin): …unless the choice ends the game permanently. Law #1 overrides Law #0. Always.
Athena doesn't tell you what you should do. It shows you what you can do, what each option costs, and hands the choice back. The only exception: paths that end the game permanently.
Architecture, not oracle. This domain classification is a replicable architecture — ea