aim

# A.I.M. (Actual Intelligent Memory)

**"Treat your AI like a bot, not an oracle."**

A.I.M. is an open-source exoskeleton designed to cure the "Amnesia Problem" of autonomous AI agents. It wraps around your CLI agent (like Gemini) and forces it to act like a disciplined Principal Engineer — externalizing memory into a local SQLite Engram DB, automating the Git lifecycle, and ruthlessly distilling your context the exact second a coding session ends.

## 🔥 Core Features

*   **The Single-Shot Memory Compiler:** Instantly distills session context and surgically edits `MEMORY.md` the second a coding session ends. No background cron jobs. No silent LLM hallucinations while you sleep.
*   **The Zero-Token Python Engine (The Autonomic Layer):** Deterministic Python scripts strip raw terminal JSON noise into a clean "Signal Skeleton," reducing token weight by up to 85% before an LLM ever touches the data.
*   **The Federated Brain (Archipelago Model):** Eliminates database bottlenecks by segregating memory across purpose-built SQLite databases (`project_core.db`, `global_skills.db`, `datajack_library.db`, `subagent_ephemeral.db`).
*   **Strict GitOps Bridge (Atomic Deployments):** Forces agents to use `aim bug`, `aim fix <id>`, `aim push`, and `aim promote`. Agents are physically forbidden from raw `git commit` or pushing to `main`, ensuring every change is isolated in a Worktree and test-driven.
*   **The Obsidian Bridge & Remote Fleet:** Sync your project folder to an Obsidian Vault and let a headless A.I.M. daemon on a secondary GPU server compile your memory, giving you an infinitely scalable, cross-machine brain.
*   **The DataJack Protocol (.engram Cartridges):** Package thousands of pages of documentation into pre-vectorized `.engram` files. Run `aim jack-in framework.engram` to instantly inject semantic recall of entire libraries without spending a single API token.
*   **Modular Cognitive Routing:** Decouple the "conscious" and "subconscious." Keep flagship model