repomemory

AI agents lose context every session. repomemory fixes that — one command creates a persistent, searchable knowledge base that any AI tool can read, search, and write to.

Every time you open a project with Claude Code, Cursor, Copilot, or any AI coding agent:

- It re-discovers your architecture from scratch
- It proposes changes that were already debated and rejected
- It re-introduces bugs that were already fixed

YourCLAUDE.md/.cursorruleshelps, but it's static and gets stale.

.context/ ├── index.md ← Quick orientation (loaded every session) ├── facts/ ← Architecture, database, deployment ├── decisions/ ← "We chose Drizzle over Prisma because..." ├── regressions/ ← "This broke before. Here's what happened." ├── preferences/ ← Your coding style — follows you across all repos ├── sessions/ ← Auto-captured AI session summaries └── changelog/ ← Monthly git history syncs

Factstell agents how things work.Decisionsprevent re-debating.Regressionsprevent re-breaking.Preferencesteach agents how you code.

With an API key (Claude Code, terminal workflows)

One command: sets up global profile, creates.context/, configures Claude Code + Cursor, runs AI analysis, prints CLAUDE.md instructions.

- MCP serverin~/.cursor/mcp.json(auto-starts repomemory in every project)
- Rulesin.cursor/rules/repomemory.mdc(teaches Cursor's AI to use context)
- 6 commandsin.cursor/commands/(run with/in Cursor chat)

Cursor's own AI scans your repo and populates.context/via the MCP tools. No external API key required — your Cursor subscription handles it.

Walks through provider selection, tool integration, and first analysis. If no API keys are detected, offers a"None — I use Cursor"option that skips external analysis entirely.

npx repomemory go --yes --provider anthropic --embedding-provider gemini --max-files 80

No prompts when--yes/--defaults/--no-promptis used.

The real power is the MCP server. When configured viarepomemory setup claude, it auto-starts with Claude Code and gives agents 7 tools:

Agent: "Let me orient myself in this project..." → context_auto_orient() → Returns: project overview, preferences, recent sessions, recent changes Agent: "Let me search for context about the auth flow..." → context_search("authentication flow") → Auto-routes to facts/ category, returns compact results Agent: "I found a race condition. Let me record this." → context_write(category="regressions", filename="token-refresh-race", content="...") → Persisted. Detects if it supersedes an existing entry.

Sessions are auto-captured on shutdown. Zero config —repomemory setup claudehandles everything.

Cursor users:You don't need any API key. Runnpx repomemory setup cursor, then use/repomemory-analyzein Cursor chat. Cursor's AI does the analysis using the MCP tools — whatever model Cursor is using (it can even switch models mid-task).

Embeddings(optional, for semantic search): Geminitext-embedding-004(free, default) or OpenAItext-embedding-3-small. Auto-detected from available API keys.

repomemory go # One-command setup (add --yes for non-interactive) repomemory wizard # Interactive guided setup repomemory analyze # AI-powered repo analysis repomemory analyze --merge # Update without overwriting edits repomemory analyze --dry-run # Preview without API call repomemory search <query> # Search knowledge base from terminal repomemory status # Coverage and freshness report repomemory doctor # Diagnostics and health check repomemory dashboard # Local web UI (localhost:3333) repomemory risk # Hotspots, coupling, ownership analysis repomemory risk -f src/auth.ts # Targeted risk assessment for specific files repomemory sync # Sync git history to changelog repomemory setup <tool> # Configure Claude/Cursor/Copilot/etc repomemory hook install # Auto-sync changelog on commits repomemory global list # Manage global developer context repomemory global export # Export global context as JSON

.repomemory.jsonin your repo root (all fields optional):

{ "provider": "anthropic", "model": "claude-sonnet-4-6", "embeddingProvider": "gemini", "hybridAlpha": 0.5, "maxFilesForAnalysis": 80, "enableGlobalContext": true }

CustomignorePatternsandkeyFilePatternsareadditive— they extend built-in defaults, not replace them.

repomemory doesn't replaceCLAUDE.md— it complements it.CLAUDE.mdis for instructions and rules..context/holds the knowledge that grows over time.

SeeCONTRIBUTING.mdfor development setup, testing, and contribution guidelines.

Searching and access your AI coding sessions from Claude Code, Gemini CLI, opencode, and OpenAI Codex.