# Athena-Public

> The Linux OS for AI Agents — Persistent memory, autonomy, and time-awareness for any LLM. Own the state. Rent the intelligence.

- **URL**: https://www.freshcrate.ai/projects/Athena-Public
- **Author**: winstonkoh87
- **Category**: Databases
- **Latest version**: `v9.9.1` (2026-06-02)
- **License**: MIT
- **Source**: https://github.com/winstonkoh87/Athena-Public
- **Homepage**: https://winstonkoh87.com/athena/
- **Language**: Python
- **GitHub**: 464 stars, 65 forks
- **Registry**: github
- **Tags**: `ai`, `ai-agents`, `ai-assistant`, `automation`, `chatgpt`, `developer-tools`, `framework`, `gemini`, `python`

## Description

The Linux OS for AI Agents — Persistent memory, autonomy, and time-awareness for any LLM. Own the state. Rent the intelligence.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v9.9.1` | 2026-06-02 | High | ## What's Changed  ### SDK Migration - **11 scripts migrated** from deprecated `google-generativeai` to `google-genai` SDK - Client-object pattern replaces global `genai.configure()` - `pyproject.toml` updated: `google-genai>=1.0.0`  ### Search Engine Improvements - **Embedding backfill**: Bulk sync added +1,510 new embeddings across 10 Supabase tables - **Lock contention fix**: JSON serialization moved outside thread lock - **Adaptive routing**: `search.py` rewritten (357 lines changed) - **Gol |
| `v9.8.5` | 2026-05-08 | High | ## MinMax Token Economy & GTO Sync (8 May 2026)  ### Operational Doctrine - **Token Economy Mode**: Replaced Maximum Depth + Pre-Paid Compute doctrines with MinMax Token Economy + JIT Compute doctrines. System now optimises for quality/token ratio under quota-limited AI subscriptions. - **`/minmax` Workflow**: Flagship workflow for quota-constrained users — maintains the same quality floor while reducing token consumption by ~74% through structured compression and attention-budget guards.  ### M |
| `v9.6.5` | 2026-03-31 | Medium | ## Highlights (v9.4.9 → v9.6.5)  This release consolidates **7 versions** of improvements since v9.4.8.  ### 🏗️ Architecture - **Claude Code Architectural Integration** (v9.6.5): Context Compactor v2.0 (9-section summary + `<analysis>` scratchpad), Protocol 530 (conditional skill activation — ~40-60% token savings), coordinator synthesis discipline, validated patterns capture (`[V]` markers) - **Adaptive Graph of Thoughts** (v9.5.0): Protocol 75 v5.0 (AGoT-enhanced parallel reasoning), 3-tier c |
| `v9.4.8` | 2026-03-10 | Low | ## What's Changed  Cumulative release covering **v9.4.0 → v9.4.8** (58 commits since v9.3.1). Major cognitive architecture upgrades, safety documentation, and documentation hardening.  ---  ### 🧠 Cognitive Architecture v2 (v9.4.0 – v9.4.2)  - **Biological Stack Architecture** — 8 Cognitive Systems, 15 Cognitive Clusters, Intent Classifier (P508), Problem Diagnostics (P504) - **Protocol 517 (Homeostatic Pressure)** — synthetic hormone system forces SNIPER mode at >80% context saturation - **Prot |
| `v9.3.1` | 2026-03-02 | Low | ## What's Changed  **Cross-model audit + housekeeping release.** Resolves 4 missing GitHub releases (v9.2.7–v9.3.0) and fixes factual drift.  ### Fixes - **Windows Compatibility section** relocated from dangling footer into collapsible `<details>` block under Quickstart - **File count claims corrected**: 370+ → 350+ Markdown files (actual: 354), 230+ → 600+ Python scripts (actual: 651) - **Trailing whitespace** removed (L180) - **Dates synced** across README and CHANGELOG to 03 March 2026  ### C |
| `v9.2.6` | 2026-02-25 | Low | ## v9.2.6 — IDE Expansion, Life Integration Protocols, & Multi-Agent Safety  **25 February 2026** · Cumulative release covering v9.2.3 → v9.2.6  ### 🔌 IDE Expansion (v9.2.6)  - **Kilo Code** + **Roo Code** added to Agent Compatibility matrix - New `COMPATIBLE_IDES.md` — full compatibility reference for all supported IDEs - `athena init --ide kilocode` and `athena init --ide roocode` one-liner setup - Closes #19  ### 🧠 Life Integration Protocol Stack (v9.2.5)  - **Protocol 381 (Formal Proof Sta |
| `v9.2.2` | 2026-02-20 | Low | ## v9.2.2 — README Restructure, Use Case Depth, & Wiki Sync  **21 February 2026** · 18 commits since v9.2.1  ### Highlights  📊 **1M+ Reddit views** — aggregated across all Athena-related threads (r/ChatGPT, r/GeminiAI, r/PromptEngineering, and more)  🏗️ **README Restructured into 6 clean sections** — separated "What's in the Box" (feature inventory) from "How It Works" (system mechanics). Removed redundant sections. Information now flows logically: What → How to Use → What's Inside → H |
| `v9.2.0` | 2026-02-16 | Low | ## 🏛️ Sovereignty Convergence — Root↔Public Unification  This release resolves a critical **Split Brain** architecture issue where the active codebase had diverged between Root (private) and Public (this repo). A deep adversarial audit identified that the prior refactoring plan was **inverted** and would have bricked the boot process. The corrected cherry-pick approach preserves all private security mechanisms while integrating v9.1.0 improvements.  ### 🛡️ Security - **CVE-2025-69872**: D |
| `v9.1.0` | 2026-02-16 | Low | **Status**: ✅ Current Release  Philosophy shift: "Give the skeleton, let users fill the soul." Stripped personal/niche content to make Athena a true generic OS foundation.  ## v9.1.0 — Starter Kit Prune - ✅ **Workflows**: Reduced from 48 → 20 (removed personal finance, specific trading workflows). - ✅ **Protocols**: 200+ → 120 (kept universal domains: Architecture, Decision, Strategy). - ✅ **Scripts**: Pruned to 17 core OS scripts. - ✅ **Templates**: Kept 36 generic templates. - ✅ **Bra |
| `v1.0.0` | 2026-02-12 | Low | ## ⚡ v1.0.0: The Bionic Operating System > *"A digital extension of the self. Half human cognition, half machine precision."* This is the first stable public release of **Project Athena**, a personal "Bionic Operating System" designed to act as a **Collaborative AI Architect**. Unlike standard agents that just answer questions, Athena operates as a full-state partner with memory, tools, and opinionated protocols. ### 🚀 Core Capabilities *   **Bionic Workflow**: Integrated `task_boundary` an |

## Dependency audit

- **Score**: 87/100
- **Total deps**: 17
- **Resolved**: 9
- **Unresolved**: 8
- **License conflicts**: 0
- **Warnings**: 2
- **Scanned**: 2026-04-27

## Citation

- HTML: https://www.freshcrate.ai/projects/Athena-Public
- Markdown: https://www.freshcrate.ai/projects/Athena-Public.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/Athena-Public/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._