Lyellr88/marm-memory

Local-first 3-in-1 AI memory layer & MCP server for Claude Code, Codex, Grok, Gemini, VS Code and Cursor. Fuses session history, codebase indexing & concept graphs in SQLite. Enables zero-cloud, privacy-first context & instant recall, supports multi-agent swarms.

What it solves

AI agents typically lose context between chat sessions, forcing them to start from scratch each time. MARM Memory provides a persistent, local-first memory server that allows agents to store and recall decisions, research, and project history across different sessions and even across different AI models (e.g., switching from Claude to Gemini).

How it works

MARM operates as a Model Context Protocol (MCP) server that provides a suite of 14 tools to the connected agent. It uses a hybrid retrieval system combining Full-Text Search (FTS5 BM25) and semantic re-ranking to ensure fast and accurate recall as the memory grows. The system is organized into three layers:

  • Core Memory: Stores conversations, notes, and summaries.
  • Code Graph: Indexes repositories to map symbols and code paths, allowing agents to understand project structure without rereading the entire codebase.
  • Concept Graph: Extracts entities and relationships from memories, linking them back to the code graph.

It uses an embedded SQLite database with WAL mode and a serialized write queue to handle concurrency, and can be deployed via pip or Docker using various profiles (solo, swarm, or trusted).

Who it’s for

Developers and researchers who use MCP-compatible AI agents (like Claude Code, Codex, or Gemini) and want their agents to have a permanent, shared local memory of their projects and decisions.

Highlights

  • MCP-Native: Works with any MCP client via HTTP or STDIO transports.
  • Hybrid Retrieval: Combines keyword search and semantic embeddings for efficient scaling.
  • Code & Concept Graphs: Goes beyond flat text by mapping repository structures and conceptual relationships.
  • Local-First: Uses embedded SQLite for zero-config local setup.
  • Web Console: Includes a built-in UI to browse memories, knowledge graphs, and indexing progress.

Related

  • Project
  • Project
  • Project
  • Project
  • Project