Repo Memory MCP server

<!-- mcp-name: io.github.yubinkim444/repo-memory -->

repo-memory

Shared, git-tracked working memory for AI agents that share a codebase.

What one Claude / Cursor / Cline learns about your repo, the next one

picks up automatically. No database. No SaaS. Just files in your repo.

The problem

Every AI session that touches your repo starts from zero. It re-greps the same files. It re-discovers the same conventions. It re-asks the same questions you already answered three sessions ago. Multi-user / multi-tool makes it worse: your teammate's Cursor and your Claude Code learn the same codebase independently.

There is CLAUDE.md / .cursorrules for rules the human writes. But there is nothing for facts an agent verified — "the auth middleware lives at src/auth/middleware.py:42", "PR #387 chose httpx over requests because of HTTP/2", "don't run migrations during peak hours".

repo-memory is that nothing. A .ai-memory/ directory you commit to your repo. Every AI tool reads from it, writes to it. Git is the database.

Layout

your-repo/
├── .ai-memory/
│   ├── README.md           # explains the convention
│   ├── facts.jsonl         # append-only structured facts with evidence
│   ├── decisions/          # one markdown per non-trivial decision
│   │   └── 2026-05-19-pick-httpx.md
│   └── gotchas.md          # one-line "watch out for X" notes
├── src/
└── README.md

Pure files. Sync over git. No daemon, no DB, no auth. Works offline.

Install

pip install repo-memory-mcp
# or
uvx repo-memory-mcp --help

Python ≥3.10. Depends only on the official mcp SDK (for the MCP server).

Quick start

cd your-repo
repo-memory init                              # creates .ai-memory/ + adds CLAUDE.md hint
repo-memory add-fact "Auth middleware lives in src/auth/middleware.py" \
                     --file src/auth/middleware.py --lines 42-180 --tool grep
repo-memory add-decision "Use httpx not requests" \
                         --body "HTTP/2 + async support; we already use anyio."
repo-memory add-gotcha "Don't run migrations during 9-11am UTC peak"

repo-memory show                              # render everything as Markdown
repo-memory list-facts --tag auth

Then commit .ai-memory/ like any other file:

git add .ai-memory/
git commit -m "memory: record auth middleware location + httpx decision"
git push

Anyone else (human or AI) who pulls the repo now sees those facts/decisions immediately.

LLM & AI Agent Readable Specification

For agents discovering this repo through search or MCP indexing.

Identity

current codebase so multiple AI agents (and humans) don't re-learn it.

• name: repo-memory
• purpose: read/write a structured, git-tracked memory store about the

• transport: CLI (repo-memory) and MCP stdio (repo-memory-mcp).
• storage: plain files under .ai-memory/ in the repo. Sync = git.

When to call which tool

Recommended agent workflow

Shortened. The full README is on GitHub.