AVIDS2/memorix
Open-source cross-agent memory layer for coding agents via MCP. Compatible with Claude Code, Codex, Cursor, Windsurf, Gemini CLI, Antigravity, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Copilot, Kiro, OpenCode, and Trae.
613 ★46 forksTypeScriptUpdated 21h ago
What you need to know
Local-first shared memory layer for AI coding agents — one project memory system that survives new chats, IDE switches, and agent changes, exposed via MCP, hooks, CLI, SDK, and a bundled terminal agent (memcode).
Install
npm install -g memorix memorix init --global (optional defaults) memorix setup --agent claude --global (also codex, copilot, cursor, pi, gemini-cli, opencode, windsurf, kiro, antigravity, trae, openclaw, hermes, omp) Requirements: Node.js >=22.18.0 and Git (project identity is derived from the real Git root)
Usage
- •Run memorix setup --agent <agent> --global to install the recommended integration (MCP, rules, hooks, skills per agent)
- •Manual stdio MCP: {"mcpServers":{"memorix":{"command":"memorix","args":["serve"]}}}
- •For shared HTTP/dashboard: `memorix background start`, then point clients at http://localhost:3211/mcp
- •CLI memory work: memorix memory search --query "...", memorix memory long-term add/qualify/approve, memorix reasoning search
Key features
- ✓Project-scoped memory: Observation, Reasoning, Git, Code, and Curated Long-term Memory layers
- ✓Works with 15+ agents via plugin packages, MCP, project rules, hooks, skills, or the bundled terminal agent
- ✓Memory Autopilot: memorix context / resume builds bounded task-lensed briefs instead of dumping old sessions
- ✓Git Memory ingests commits into searchable engineering facts; Reasoning Memory stores design rationale
- ✓Local-first: SQLite canonical store, Orama search; LLM-backed formation/embedding optional
- ✓Orchestration: memorix orchestrate coordinates workers with worktrees, locks, verification gates
Best for
Developers who switch between multiple coding agents (Claude Code, Codex, Cursor, etc.) and want one persistent project memory across all of them
Caveats
- ⚠Requires Node.js >=22.18.0 and Git in the project
- ⚠MCP image/video generation disabled by default and requires MiniMax API key (MEMORIX_MCP_MEDIA_GENERATION=1) as it may incur provider costs
- ⚠Semantic search is a one-shot 1.8s no-retry fallback only when an embedding provider is configured; keyword search stays primary
- ⚠Long-term memory is deliberately manual: candidates never enter task context until qualified/approved
- ⚠Codex support is user-level plugin only; Memorix leaves project .codex config alone
Platforms: Node.js (cross-platform) · Docker for HTTP serviceClients: Claude Code · Codex CLI · GitHub Copilot CLI · Cursor · Windsurf · Gemini CLI · OpenCode · Kiro · Trae · Antigravity · OpenClaw · Hermes Agent · Oh-my-Pi · Pi · Any MCP client (stdio or HTTP)
Documentation ↗Reviewed 2026-08-07
Topics
agent-memoryai-codingantigravityclaude-codecodexcoding-agentscopilotcross-agent-memorycursorgemini-clihermes-agentlocal-firstmcpmcp-servermodel-context-protocoloh-my-piopenclawopencodetypescriptwindsurf
- Stars
- 613★
- Forks
- 46
- Language
- TypeScript
- License
- Apache-2.0
- Created
- 2026-02-14
- Last push
- 2026-08-06