Tessera

Memoria persistente de la base de código para Claude Code: código abierto, sin restricciones de licencia.

Tessera le proporciona a Claude Code una comprensión semántica de tu proyecto que persiste entre turnos y sesiones, eliminando relecturas redundantes de archivos y proporcionando un historial de acciones estructurado.

Cómo funciona

1. tessera scan . — construye un grafo SQLite de tu base de código (archivos, símbolos, importaciones)

2. Claude llama a graph_continue cada turno — enruta a recomendaciones de archivos almacenados en caché y puntuados

3. graph_register_edit actualiza el grafo después de las ediciones y verifica automáticamente las listas de verificación del plan

4. Opcional: ejecuta tessera debate "task" para un debate de planificación multirronda entre Claude y GPT

Related MCP server: RLM Memory MCP Server

Instalación

Plugin de Claude Code (recomendado)

claude plugin marketplace add dr-code/tessera
claude plugin install tessera@tessera

Esto registra el servidor MCP (mediante uvx — no se necesita entorno Python) y autoinstala todas las habilidades (/build, /debate, /cleanup, /plan-review, /codex-review). Luego, en cualquier proyecto:

tessera scan .          # builds graph, writes .mcp.json and CLAUDE.md

pip (manual / CI)

curl -fsSL https://raw.githubusercontent.com/dr-code/tessera/main/install.sh | bash

Cuando la CLI claude está presente, el script utiliza el mercado de plugins (registra el servidor MCP mediante uvx e instala todas las habilidades). Sin ella, recurre a pip install tessera y ofrece copiar las habilidades a ~/.claude/skills/.

Luego, en cualquier proyecto:

tessera scan .          # builds graph, writes .mcp.json and CLAUDE.md

Alternativas manuales

# Claude Code plugin (two steps)
claude plugin marketplace add dr-code/tessera
claude plugin install tessera@tessera

# pip only
pip install tessera          # core — no API keys needed
pip install tessera[debate]  # adds debate mode (requires ANTHROPIC_API_KEY + codex CLI)
pip install tessera[dashboard]
pip install tessera[all]

Inicio rápido

cd my-project
tessera scan .          # builds graph, writes .mcp.json and CLAUDE.md
tessera status          # show graph stats
tessera dashboard       # start dashboard at localhost:5050

Registro de MCP

Después de ejecutar tessera scan ., tu proyecto tendrá un .mcp.json:

{
  "mcpServers": {
    "tessera": {
      "command": "uvx",
      "args": ["--from", "tessera", "tessera", "mcp"],
      "env": { "TESSERA_PROJECT_ROOT": "/path/to/project" }
    }
  }
}

uvx obtiene y almacena en caché tessera desde PyPI en la primera ejecución: no se necesita ninguna entrada en PATH. Claude Code lo detecta automáticamente.

Referencia de CLI

tessera scan [PATH]              Build/rebuild the graph
tessera mcp                      Start MCP server (stdio)
tessera status [PATH]            Show graph stats
tessera decisions [PATH]         List locked decisions
tessera reset [PATH]             Clear action graph
tessera plans [PROJECT [SUB]]    List archived plans
tessera verify [PATH]            Compliance: plan vs git diff
tessera handoff [PATH]           Generate clipboard handoff summary
tessera debate "task" [flags]    Run Claude vs GPT debate
tessera dashboard [PATH]         Start dashboard at localhost:5050

Modo debate

Requiere pip install tessera[debate] y la CLI codex.

Conexión a ChatGPT (sin necesidad de clave API)

Si tienes una suscripción de ChatGPT Plus o Pro, puedes autenticar la CLI codex con ella: no se requiere una clave API ni configuración de facturación por separado:

npm install -g @openai/codex   # install once
codex auth login               # opens browser — sign in with your ChatGPT account

Eso es todo. tessera debate y todas las habilidades de Claude Code (/debate, /build, /cleanup, etc.) usarán tu suscripción automáticamente.

Conexión mediante clave API (opcional)

Establece OPENAI_API_KEY si prefieres la facturación directa de la API en lugar de la ruta OAuth de suscripción.

tessera debate "Add JWT authentication" \
  --project myapp \
  --subtask auth-middleware \
  --max-rounds 3

Indicadores de características

El panel de control se enlaza a 127.0.0.1 por defecto y no tiene autenticación. Si estableces TESSERA_DASHBOARD_HOST=0.0.0.0 para acceso LAN, todas las rutas /api/* (grafo del proyecto, planes, decisiones bloqueadas) se vuelven accesibles para cualquier persona en la red sin necesidad de iniciar sesión: hazlo solo en una red de confianza.

Objetivo de ahorro de tokens

Habilidades en sesión de Claude Code

Tessera incluye cinco comandos de barra de Claude Code que usan el grafo de tessera para el contexto y la CLI de Codex para la perspectiva de GPT. La instalación desde el mercado de plugins los autoinstala desde el directorio skills/ de este repositorio. Para la instalación manual, ejecuta ./install.sh o copia desde skills/ a ~/.claude/skills/.

Requiere: la CLI codex (npm install -g @openai/codex) autenticada mediante codex auth login (suscripción de ChatGPT) o OPENAI_API_KEY.

Todas las habilidades se degradan correctamente cuando no se configura el MCP de tessera: siguen ejecutando la colaboración Claude+GPT, solo que sin contexto de grafo.

Licencia

MIT