repomemory

npx repomemory go

O Problema

Toda vez que você abre um projeto com Claude Code, Cursor, Copilot ou qualquer agente de codificação de IA:

• Ele redescobre sua arquitetura do zero
• Ele propõe mudanças que já foram debatidas e rejeitadas
• Ele reintroduz bugs que já foram corrigidos

Seu CLAUDE.md / .cursorrules ajuda, mas é estático e fica desatualizado.

A Solução

.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

Fatos dizem aos agentes como as coisas funcionam. Decisões evitam re-debates. Regressões evitam re-quebras. Preferências ensinam aos agentes como você codifica.

Início Rápido

Com uma chave de API (Claude Code, fluxos de terminal)

npx repomemory go

Um comando: configura o perfil global, cria .context/, configura Claude Code + Cursor, executa análise de IA e imprime instruções do CLAUDE.md.

Com Cursor (sem necessidade de chave de API)

npx repomemory setup cursor

Isso instala tudo o que o Cursor precisa:

• Servidor MCP em ~/.cursor/mcp.json (inicia automaticamente o repomemory em todo projeto)
• Regras em .cursor/rules/repomemory.mdc (ensina a IA do Cursor a usar contexto)
• 6 comandos em .cursor/commands/ (execute com / no chat do Cursor)

Então, no chat do Cursor, digite:

/repomemory-analyze

A própria IA do Cursor escaneia seu repositório e popula .context/ por meio das ferramentas MCP. Nenhuma chave de API externa é necessária — sua assinatura do Cursor cuida disso.

Comandos disponíveis no Cursor:

Assistente guiado

npx repomemory wizard

Orienta pela seleção de provedor, integração de ferramentas e primeira análise. Se nenhuma chave de API for detectada, oferece uma opção "Nenhuma — eu uso Cursor" que pula a análise externa completamente.

Não interativo (seguro para CI)

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

Sem prompts quando --yes / --defaults / --no-prompt é usado.

Servidor MCP — Agentes com Memória Real

O verdadeiro poder é o servidor MCP. Quando configurado via repomemory setup claude, ele inicia automaticamente com Claude Code e dá aos agentes 7 ferramentas:

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.

Sessões são capturadas automaticamente no encerramento. Zero configuração — repomemory setup claude cuida de tudo.

Ferramentas Suportadas

Usuários do Cursor: Você não precisa de nenhuma chave de API. Execute npx repomemory setup cursor, depois use /repomemory-analyze no chat do Cursor. A IA do Cursor faz a análise usando as ferramentas MCP — qualquer modelo que o Cursor esteja usando (ele pode até trocar de modelo no meio da tarefa).

Provedores Suportados

Embeddings (opcional, para pesquisa semântica): Gemini text-embedding-004 (grátis, padrão) ou OpenAI text-embedding-3-small. Detectados automaticamente a partir das chaves de API disponíveis.

Todos os Comandos

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

Configuração

.repomemory.json na raiz do seu repositório (todos os campos opcionais):

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

ignorePatterns e keyFilePatterns personalizados são aditivos — eles estendem os padrões integrados, não os substituem.

Por que não apenas CLAUDE.md?

repomemory não substitui CLAUDE.md — ele complementa. CLAUDE.md é para instruções e regras. .context/ guarda o conhecimento que cresce com o tempo.

Contribuindo

Veja CONTRIBUTING.md para configuração de desenvolvimento, testes e diretrizes de contribuição.

Licença

MIT