$git clone https://github.com/AVIDS2/memorix---
| 1 | <p align="center"> |
| 2 | <img src="https://raw.githubusercontent.com/AVIDS2/memorix/main/assets/readme-hero.svg" alt="Memorix" width="720"> |
| 3 | </p> |
| 4 | |
| 5 | <h1 align="center">Memorix</h1> |
| 6 | |
| 7 | <p align="center"> |
| 8 | <strong>Local-first shared memory layer for AI coding agents.</strong><br> |
| 9 | One project memory system for Claude Code, Codex, Cursor, Windsurf, Copilot, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, and any MCP-capable agent. |
| 10 | </p> |
| 11 | |
| 12 | <p align="center"> |
| 13 | <a href="https://www.npmjs.com/package/memorix"><img src="https://img.shields.io/npm/v/memorix.svg?style=for-the-badge&logo=npm&color=cb3837" alt="npm"></a> |
| 14 | <a href="https://www.npmjs.com/package/memorix"><img src="https://img.shields.io/npm/dm/memorix.svg?style=for-the-badge&logo=npm&label=monthly%20downloads&color=7c3aed" alt="monthly downloads"></a> |
| 15 | <a href="https://github.com/AVIDS2/memorix/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/AVIDS2/memorix/ci.yml?style=for-the-badge&label=CI&logo=github" alt="CI"></a> |
| 16 | <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-2563eb?style=for-the-badge" alt="license"></a> |
| 17 | <a href="https://github.com/AVIDS2/memorix"><img src="https://img.shields.io/github/stars/AVIDS2/memorix?style=for-the-badge&logo=github&color=facc15" alt="stars"></a> |
| 18 | </p> |
| 19 | |
| 20 | <p align="center"> |
| 21 | <strong>Shared Project Memory</strong> | <strong>MCP</strong> | <strong>Git Memory</strong> | <strong>Reasoning Memory</strong> | <strong>Plugins</strong> | <strong>Orchestration</strong> |
| 22 | </p> |
| 23 | |
| 24 | <p align="center"> |
| 25 | <a href="README.zh-CN.md">Chinese</a> | |
| 26 | <a href="#install">Install</a> | |
| 27 | <a href="#capabilities">Capabilities</a> | |
| 28 | <a href="#works-with-your-agent">Agents</a> | |
| 29 | <a href="#quick-start">Quick Start</a> | |
| 30 | <a href="#memory-model">Memory Model</a> | |
| 31 | <a href="#memcode-bundled-terminal-agent">memcode</a> | |
| 32 | <a href="#docs">Docs</a> |
| 33 | </p> |
| 34 | |
| 35 | --- |
| 36 | |
| 37 | <h2 id="what-memorix-is"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-overview.svg"><img src="assets/tags/section-overview.svg" alt="Memorix" height="32" /></picture></h2> |
| 38 | |
| 39 | Memorix gives the AI coding agents you already use a shared, searchable project memory that survives new chats, IDE switches, terminal sessions, and handoffs. The memory lives under the Git project, not inside one chat window or one tool. |
| 40 | |
| 41 | Use Claude Code today, Codex tomorrow, and Cursor in the afternoon. The agent can change; the project memory stays the same. |
| 42 | |
| 43 | **Use Memorix when** you keep re-explaining the same project to a new agent session: the last session already figured something out, another IDE cannot see it, or a design decision is buried in a chat you cannot find anymore. |
| 44 | |
| 45 | | Problem | What Memorix adds | |
| 46 | | --- | --- | |
| 47 | | The next session forgets what the last session learned | Project-scoped memory, session summaries, timelines, and detail retrieval | |
| 48 | | Different agents know different things | One local memory pool available through MCP, hooks, CLI, SDK, and the bundled terminal agent | |
| 49 | | Git records what changed, but agents cannot recall it well | Git Memory turns commits into searchable engineering facts | |
| 50 | | Architecture decisions disappear into old chats | Reasoning Memory stores why choices were made, with alternatives and trade-offs | |
| 51 | | Static rule files drift | Gotchas, fixes, and project skills evolve from real work | |
| 52 | | Parallel agent work gets messy | `memorix orchestrate` coordinates task context, handoffs, locks, verification, and review loops | |
| 53 | |
| 54 | Memorix is local-first. SQLite is the canonical store, Orama handles search, and LLM-backed formation/embedding is optional. Without model keys, Memorix still works with local full-text retrieval. |
| 55 | |
| 56 | ### Capabilities |
| 57 | |
| 58 | Memorix is more than a memory store. It also installs agent integrations, keeps useful work events, turns commits into project facts, exposes a local control plane, and can coordinate multi-agent work when a task needs it. |
| 59 | |
| 60 | | C |