Tages

Memoria de equipo para agentes de codificación de IA.

Tus agentes de IA olvidan todo entre sesiones. Cada decisión se vuelve a cuestionar. Cada convención se vuelve a explicar. Cada error pasado se repite por el siguiente agente que toca el mismo código.

Las herramientas de memoria personal parchean el síntoma: almacenan algunos hechos y los recuperan más tarde. Eso funciona para desarrolladores solitarios que recuerdan lo que almacenaron. Pero falla cuando los equipos trabajan con IA: cuando tres desarrolladores usan agentes en la misma base de código, cuando la incorporación requiere transferir conocimiento institucional, cuando la memoria incorrecta sobrevive a una refactorización porque nadie la auditó.

La memoria no es almacenamiento. Es una práctica de equipo.

Tages trata la memoria de la base de código como un artefacto gestionado: tipos estructurados, puntuación de calidad, pistas de auditoría y pases de refinamiento que reescriben notas vagas en instrucciones imperativas para el agente. La decisión de arquitectura de un desarrollador se convierte en el contexto de todos los agentes. Una mala memoria se marca y corrige antes de que engañe a la siguiente sesión.

Comienza en menos de 60 segundos con un comando. Añade funciones de equipo cuando tu flujo de trabajo lo exija.

claude mcp add tages -- npx -y @tages/server

¿Por qué Tages?

Qué recuerda

El código fuente le dice a los agentes qué existe. Tages les dice por qué se construyó, cómo trabajar con ello y qué no hacer.

Además: entidad, ejecución, operacional, entorno, preferencia (11 tipos en total).

Cómo funciona

1. Instalar — tages init se conecta a tu proyecto, o instala el plugin de Claude Code para una configuración sin esfuerzo.

2. Recordar — Almacena decisiones y convenciones manualmente, mediante git hooks o importando CLAUDE.md.

3. Recordar — Cada sesión obtiene el contexto completo del proyecto en <10ms desde la caché local de SQLite.

Detección automática sin configuración

Al ejecutarse como plugin de Claude Code o servidor MCP, Tages detecta automáticamente en qué proyecto te encuentras:

1. .tages/config.json — archivo marcador explícito (creado por tages link).

2. Git remote — compara el nombre del repositorio con los proyectos registrados.

3. Nombre del directorio — compara el nombre de la carpeta con los slugs de proyectos registrados.

4. Creación automática — si estás autenticado, crea un nuevo proyecto en la nube automáticamente; de lo contrario, usa el modo solo local.

No se requiere tages init por directorio. Usa tages link [slug] para vincular explícitamente un directorio a un proyecto.

Plugin de Claude Code

Instala Tages como un plugin de Claude Code para la memoria automática de sesiones:

/plugin https://github.com/ryantlee25-droid/tages

Funciona con

Claude Code, Cursor, Codex, Gemini: cualquier cosa que hable MCP.

Características

• 56 herramientas MCP — recordar, recuperar, auditar, refinar, importar, federación, analíticas y más.

• 52 comandos CLI — control total desde la terminal.

• Panel web — navega, busca y edita memorias con una interfaz en modo oscuro.

• Auto-indexación — los git hooks extraen decisiones de los commits mediante Ollama o Claude Haiku.

• Importación — semilla desde archivos CLAUDE.md, ARCHITECTURE.md o JSON existentes.

• tages brief — genera un documento de contexto en caché para la inyección en el prompt del sistema.

• tages audit — puntúa tu cobertura de memoria y obtén sugerencias de mejora.

• tages sharpen — reescribe memorias en forma imperativa para un mejor consumo por parte del agente.

• Local-first — caché SQLite para consultas de menos de 10ms, funciona sin conexión.

• Búsqueda híbrida — coincidencia de trigramas pg_trgm + búsqueda semántica pgvector.

• Compartir en equipo — múltiples desarrolladores comparten la memoria de una misma base de código (Pro).

Benchmarks

En cinco pruebas comparativas directas, los agentes con contexto de Tages obtuvieron hasta 9.1/10 frente a 2.8/10 sin él, con deltas de calidad que escalan desde +1.0 en tareas simples hasta +6.3 en tareas complejas. Las mayores ganancias se dieron en el cumplimiento de convenciones, cableado de integraciones y evitación de trampas. Los agentes sin memoria crearon constantemente código huérfano que no se conectaba con los subsistemas existentes.

Guías de configuración

• Inicio rápido

• Claude Code

• Cursor

• Codex

• Gemini

• GitHub Actions

• Autohospedaje

Arquitectura

packages/
  server/     MCP server (56 tools, stdio transport, 445 tests)
  cli/        CLI (52 commands, npm global install, 76 tests)
  shared/     TypeScript types + Supabase client
apps/
  dashboard/  Next.js 16, Supabase Auth, Tailwind, shadcn/ui
supabase/
  migrations/ 42 migrations (tables, RLS, pgvector, RBAC, encryption)

Seguridad

• Cifrado en reposo — AES-256-GCM para valores de memoria (opcional).

• RBAC — Escritura para propietario/administrador, solo lectura para miembros.

• Seguridad a nivel de fila — Todas las tablas aplican la pertenencia al proyecto en la capa de base de datos.

• Autenticación — Supabase Auth + GitHub OAuth; tokens de API con hash SHA-256 y expiración.

• Detección de secretos — Las memorias se escanean en busca de claves de API, credenciales e información personal antes de almacenarse.

• Registro de auditoría — Se rastrean eventos de autenticación, exportaciones y validación de tokens.

Consulta SECURITY.md para nuestra política de seguridad completa y proceso de divulgación responsable. Consulta PRIVACY.md para nuestra política de privacidad.

Precios

Contribución

Consulta CONTRIBUTING.md para la configuración de desarrollo y directrices.

Licencia

MIT

Nombrado en honor a

Tages: el niño divino etrusco que apareció de un surco en la tierra y dictó el conocimiento sagrado a los escribas antes de desaparecer. El conocimiento persistió mucho después de que la fuente se hubiera ido.