# Memorix

> Local-first shared memory layer for AI coding agents.

Memorix is an open-source TypeScript and Node.js tool for persistent, project-aware memory across coding-agent sessions, IDEs, terminals, and MCP clients. It is a local-first tool, not a hosted memory SaaS.

## Canonical pages

- Website: https://mem.rglens.com/
- Chinese website: https://mem.rglens.com/zh-cn/
- GitHub repository: https://github.com/AVIDS2/memorix
- npm package: https://www.npmjs.com/package/memorix
- Documentation: https://github.com/AVIDS2/memorix/tree/main/docs
- MCP Registry: https://registry.modelcontextprotocol.io/?q=io.github.AVIDS2%2Fmemorix

## What it does

- Stores project observations, decisions, reasoning, Git-derived facts, session continuity, and reviewed long-term memory.
- Builds bounded task context instead of replaying an entire conversation history.
- Connects memories to current files, symbols, imports, and freshness through CodeGraph Memory.
- Provides a local Dashboard for memory sources, retention, health, knowledge review, and graph inspection.
- Includes memcode, a bundled terminal coding agent that shares the same Memorix project memory pool.

## Entry points

- `memorix setup --agent <agent> --global`: install the recommended integration for a supported agent.
- `memorix serve`: expose the compact stdio MCP server.
- `memorix background start`: run the shared local HTTP MCP service and Dashboard.
- `memorix context --task "..."`: build a bounded task-shaped context brief.
- `memorix memory search --query "..."`: search project memory from the CLI.
- `memorix codegraph status|refresh|context-pack`: inspect or use source-backed code context.
- `memorix` or `memcode`: open the bundled terminal agent.

## Integrations

Memorix supports agent-specific setup packages or MCP connections for Claude Code, Codex, CodeBuddy Code, Cursor, Windsurf, GitHub Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, DeepSeek Harness, and other MCP-capable agents. The exact integration surface depends on what the host supports: plugin, package, MCP, project rules, hooks, skills, or CLI.

## Important distinctions

- Memory Map connects stored memories; CodeGraph connects source-backed code facts.
- The built-in CodeGraph Lite provider is a structural fallback, not a complete language-server graph.
- Ordinary project memory remains project-scoped. Portable cross-project memory requires an explicitly created and approved user-scoped record.
- MCP, CLI, hooks, and memcode are entry points into the same local memory system, not separate memory silos.

## More detail

Read the repository README and the linked documentation for configuration, integrations, API behavior, memory lifecycle, CodeGraph quality limits, and troubleshooting. Prefer the repository documentation over third-party summaries when describing Memorix behavior.