Repo Memory

Name: Repo Memory
Author: yubinkim444

@yubinkim444

Repository

About Repo Memory

A different approach from typical persistent-memory MCPs. Instead of a local

#memory #knowledge-base #ai-agents #claude-code #cursor #cline

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "repo-memory": {
      "command": "uvx",
      "args": [
        "repo-memory-mcp",
        "--repo",
        "/path/to/your/repo"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Repo Memory?

Repo Memory is a shared, git-tracked working memory for AI agents that share a codebase. It stores structured facts, decisions, and gotchas in plain files under a .ai-memory/ directory, synchronized via git. It is designed for developers using AI coding assistants such as Claude, Cursor, or Cline.

How to use Repo Memory?

Install with pip install repo-memory or run via uvx. Initialize memory in your repo with repo-memory init, then use commands such as repo-memory add-fact, add-decision, or add-gotcha. For AI agent integration, add an MCP server entry in your client config pointing to repo-memory-mcp with the repo path.

Key features of Repo Memory

Git-tracked, append-only facts with evidence
No database, no SaaS, no daemon; works offline
Structured facts, decisions, and gotchas as plain files
Per-repo scope – memory stays local to the codebase
MCP server with 5 tools for read/write access
Automatic discovery hint in CLAUDE.md or AGENTS.md

Use cases of Repo Memory

Sharing known facts across AI agent sessions on the same repository
Recording architecture decisions and non-obvious conventions
Avoiding repeated grep or re-discovery of codebase structure
Multi-user or multi-tool collaboration on a shared codebase

FAQ from Repo Memory

How is Repo Memory different from `CLAUDE.md` or `.cursorrules`?

CLAUDE.md is for rules that a human writes; Repo Memory is for facts that an agent verifies – locations, behaviors, and decisions discovered during work.

What are the runtime requirements?

Python 3.10 or later. The only dependency is the official MCP SDK.

Where does Repo Memory store data?

In a .ai-memory/ directory inside the repository. The data is plain files (facts.jsonl, decisions/, gotchas.md) and is synchronized via normal git commits and pushes.

What transport does the MCP server use?

It uses stdio transport. The server is launched via repo-memory-mcp with a --repo argument or the REPO_MEMORY_ROOT environment variable.

How do multiple agents avoid conflicting facts?

Facts are append-only; stale entries remain. Readers check verified_at to re-verify if needed. Suspicious facts are filtered through normal code review via git.

Comments

More Memory & Knowledge MCP servers

RAG Documentation MCP Server

hannesrudolph

An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context.

267

Notion MCP Server

makenotion

Official Notion MCP Server

4.5K

Semantic Scholar MCP Server

YUZongmin

A FastMCP server implementation for the Semantic Scholar API, providing comprehensive access to academic paper data, author information, and citation networks.

158

Context Portal MCP (ConPort)

GreatScottyMac

Context Portal (ConPort): A memory bank MCP server building a project-specific knowledge graph to supercharge AI assistants. Enables powerful Retrieval Augmented Generation (RAG) for context-aware development in your IDE.

763

Notion MCP Integration

danhilse

A simple MCP integration that allows Claude to read and manage a personal Notion todo list

208