repomemory

npx repomemory go

El Problema

Cada vez que abres un proyecto con Claude Code, Cursor, Copilot o cualquier agente de codificación con IA:

• Redescubre tu arquitectura desde cero
• Propone cambios que ya fueron debatidos y rechazados
• Reintroduce errores que ya fueron corregidos

Tu CLAUDE.md / .cursorrules ayuda, pero es estático y se vuelve obsoleto.

La Solución

.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

Hechos les dicen a los agentes cómo funcionan las cosas. Decisiones evitan volver a debatir. Regresiones evitan que se vuelvan a romper. Preferencias enseñan a los agentes cómo codificas.

Inicio Rápido

Con una clave de API (Claude Code, flujos de trabajo de terminal)

npx repomemory go

Un comando: configura el perfil global, crea .context/, configura Claude Code + Cursor, ejecuta el análisis de IA e imprime las instrucciones de CLAUDE.md.

Con Cursor (sin necesidad de clave de API)

npx repomemory setup cursor

Esto instala todo lo que Cursor necesita:

• Servidor MCP en ~/.cursor/mcp.json (inicia repomemory automáticamente en cada proyecto)
• Reglas en .cursor/rules/repomemory.mdc (enseña a la IA de Cursor a usar el contexto)
• 6 comandos en .cursor/commands/ (ejecuta con / en el chat de Cursor)

Luego, en el chat de Cursor, escribe:

/repomemory-analyze

La propia IA de Cursor escanea tu repositorio y completa .context/ mediante las herramientas MCP. No se requiere clave de API externa: tu suscripción de Cursor se encarga de ello.

Comandos disponibles de Cursor:

Asistente guiado

npx repomemory wizard

Te guía a través de la selección de proveedor, la integración de herramientas y el primer análisis. Si no se detectan claves de API, ofrece una opción "Ninguna — uso Cursor" que omite por completo el análisis externo.

No interactivo (seguro para CI)

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

Sin avisos cuando se usa --yes / --defaults / --no-prompt.

Servidor MCP: agentes con memoria real

El verdadero poder es el servidor MCP. Cuando se configura mediante repomemory setup claude, se inicia automáticamente con Claude Code y les da a los agentes 7 herramientas:

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.

Las sesiones se capturan automáticamente al cerrar. Configuración cero: repomemory setup claude se encarga de todo.

Herramientas compatibles

Usuarios de Cursor: No necesitas ninguna clave de API. Ejecuta npx repomemory setup cursor y luego usa /repomemory-analyze en el chat de Cursor. La IA de Cursor realiza el análisis con las herramientas MCP, sea cual sea el modelo que Cursor esté usando (incluso puede cambiar de modelo a mitad de tarea).

Proveedores compatibles

Embeddings (opcional, para búsqueda semántica): Gemini text-embedding-004 (gratuito, predeterminado) u OpenAI text-embedding-3-small. Se detectan automáticamente a partir de las claves de API disponibles.

Todos los 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

Configuración

.repomemory.json en la raíz de tu repositorio (todos los campos son opcionales):

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

Los ignorePatterns y keyFilePatterns personalizados son aditivos: amplían los valores predeterminados integrados, no los reemplazan.

¿Por qué no solo CLAUDE.md?

repomemory no reemplaza a CLAUDE.md: lo complementa. CLAUDE.md es para instrucciones y reglas. .context/ contiene el conocimiento que crece con el tiempo.

Contribuciones

Consulta CONTRIBUTING.md para la configuración de desarrollo, las pruebas y las pautas de contribución.

Licencia

MIT