TIMPS — Memoria persistente para agentes de codificación con IA

Estado: proyecto en solitario, en fase temprana. El servidor MCP y la CLI son las partes que realmente uso a diario y en las que confío. Todo lo demás en este repositorio (aplicación de escritorio, móvil, JetBrains, mercado de plugins) es más reciente y está menos probado, como se indica abajo. Prefiero sinceramente que pruebes el núcleo y me digas que está roto a que leas texto de marketing.

Pruébalo en 30 segundos

npx timps-code "what does this codebase do?"

Sin instalación, sin configuración, sin clave de API. Apunta a cualquier repositorio. Si tienes Ollama ejecutándose localmente, esto es 100% gratis y nada sale de tu máquina. Si no, te guiará para elegir un proveedor.

Para conseguir memoria persistente de verdad en Claude Code, Cursor o cualquier cliente MCP, añade el servidor MCP:

npm install -g @timps-ai/timps-mcp

luego apunta tu cliente MCP a él (instrucciones de configuración en Configuración de MCP).

Related MCP server: Lockstep Core

Qué hace exactamente

Pídele a Claude Code que arregle un error hoy. Cierra la sesión. Pregúntale algo relacionado mañana — no tiene ni idea de lo que decidiste ayer, de lo que ya probaste, ni de por qué estructuraste algo como lo hiciste. Acabas reexplicando el mismo contexto en cada sesión.

TIMPS se sitúa entre tú y tu agente como servidor MCP y mantiene un almacén de memoria por proyecto:

• Qué recuerda — las decisiones de arquitectura que has tomado, los patrones y convenciones específicos de tu base de código, los errores con los que ya te has topado y cómo se solucionaron, y un registro de auditoría simple de lo que escribió y por qué.

• Dónde vive — archivos JSON/SQLite locales por defecto, organizados por proyecto para que distintos repositorios no se mezclen entre sí. Postgres/Qdrant opcional si quieres compartirlo en un equipo.

• Cuánto cuesta — gratis si ejecutas Ollama localmente. Proveedores de pago opcionales (Claude, GPT, Gemini) si prefieres su calidad de razonamiento.

Esa es toda la propuesta. Es una capa de memoria, no un agente nuevo — funciona junto con cualquier agente de codificación que ya uses.

Cómo funciona (versión corta)

Internamente, la memoria se organiza en varios niveles reales:

1. Memoria de trabajo — sesión actual: archivos activos, errores recientes, objetivos en vivo. Se borra al salir.

2. Memoria episódica — un registro de sesiones pasadas y sus resultados.

3. Memoria semántica — lo duradero: patrones, convenciones, decisiones que se promovieron desde la episódica porque seguían importando.

4. Registro de auditoría — un registro de solo añadido, encadenado con hash, de cada escritura de memoria, para que puedas ver exactamente qué aprendió el sistema y cuándo.

Hay un conjunto más profundo de subsistemas sobre esto (detección de patrones temporales, detección de contradicciones, puntuación de confianza, poda basada en importancia) para quienes quieran ir más allá — el desglose completo está en ARCHITECTURE.md en lugar de aquí, ya que la mayoría de la gente no necesita conocer los entresijos para usarlo.

Configuración de MCP

Claude Code

Añádelo a ~/.claude.json:

{
  "mcpServers": {
    "timps": {
      "command": "timps-mcp"
    }
  }
}

Cursor

Añádelo a .cursor/mcp.json:

{
  "mcpServers": {
    "timps": {
      "command": "timps-mcp"
    }
  }
}

Windsurf

Añádelo a ~/.config/windsurf/config.json:

{
  "mcpServers": {
    "timps": {
      "command": "timps-mcp"
    }
  }
}

Cualquier otro cliente MCP

Ejecuta timps-mcp sobre stdio. Eso es todo lo que requiere el protocolo.

Qué se mide, honestamente

Ejecútalo tú mismo: npx tsx benchmark/index.ts --quick

Estos son benchmarks ejecutados por mí mismo sobre un conjunto de datos sintético que construí — no están verificados de forma independiente y no son una afirmación sobre cómo se comporta en tu base de código real. Tómalos como "la lógica principal funciona como está diseñada", no como una afirmación competitiva.

También en este repositorio (en fase inicial / experimental)

El monorepo incluye una extensión de VS Code, una aplicación de escritorio (Tauri), una aplicación móvil, un plugin de JetBrains y un modo "swarm" multiagente para la descomposición de tareas. Existen y en su mayoría funcionan, pero han tenido mucho menos uso en el mundo real que el núcleo CLI/MCP — trátalos como "pruébalo si tienes curiosidad", no como "esto está listo para producción". Prefiero ser transparente al respecto a que te enteres a las malas.

Pruébalo y luego dime qué falla

Esto es genuinamente útil para mí ahora mismo: ejecuta el comando de 30 segundos de arriba en uno de tus repositorios reales y dime qué se rompió, qué fue confuso o qué hizo mal. Esa retroalimentación vale más para este proyecto que una estrella.

• Incidencias: github.com/Sandeeprdy1729/timps/issues

• Discord: discord.gg/MmsTNm8WF6

Licencia

MIT