Tessera

Beständiger Codebasis-Speicher für Claude Code – Open Source, keine Lizenzbeschränkung.

Tessera gibt Claude Code ein semantisches Verständnis Ihres Projekts, das über Turns und Sitzungen hinweg bestehen bleibt, vermeidet redundantes erneutes Lesen von Dateien und bietet eine strukturierte Aktionshistorie.

So funktioniert’s

1. tessera scan . – erstellt einen SQLite-Graphen Ihrer Codebasis (Dateien, Symbole, Importe)

2. Claude ruft bei jedem Turn graph_continue auf – leitet zu zwischengespeicherten, bewerteten Dateiempfehlungen weiter

3. graph_register_edit aktualisiert den Graphen nach Bearbeitungen, prüft automatisch Plan-Checklisten

4. Optional: Führen Sie tessera debate "task" für eine mehrstufige Claude-vs-GPT-Planungsdebatte aus

Related MCP server: RLM Memory MCP Server

Installation

Claude Code Plugin (empfohlen)

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

Dies registriert den MCP-Server (über uvx – keine Python-Umgebung nötig) und installiert automatisch alle Skills (/build, /debate, /cleanup, /plan-review, /codex-review). Anschließend in jedem Projekt:

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

pip (manuell / CI)

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

Wenn die claude CLI vorhanden ist, nutzt das Skript den Plugin-Marktplatz (registriert den MCP-Server über uvx und installiert alle Skills). Ohne sie fällt es auf pip install tessera zurück und bietet an, die Skills nach ~/.claude/skills/ zu kopieren.

Anschließend in jedem Projekt:

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

Manuelle Alternativen

# 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]

Schnellstart

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

MCP-Registrierung

Nach tessera scan . hat Ihr Projekt eine .mcp.json:

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

uvx lädt Tessera bei der ersten Ausführung von PyPI ab und speichert es zwischen – kein PATH-Eintrag nötig. Claude Code erkennt dies automatisch.

CLI-Referenz

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

Debattemodus

Erfordert pip install tessera[debate] und die codex CLI.

Verbindung zu ChatGPT (kein API-Schlüssel nötig)

Wenn Sie ein ChatGPT Plus- oder Pro-Abonnement haben, können Sie die codex CLI damit authentifizieren – kein separater API-Schlüssel oder Abrechnungssetup erforderlich:

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

Das war’s. tessera debate und alle Claude Code Skills (/debate, /build, /cleanup usw.) verwenden automatisch Ihr Abonnement.

Verbindung über API-Schlüssel (optional)

Setzen Sie OPENAI_API_KEY, wenn Sie die direkte API-Abrechnung gegenüber dem Abonnement-OAuth-Pfad bevorzugen.

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

Feature-Flags

Das Dashboard bindet standardmäßig an 127.0.0.1 und hat keine Authentifizierung. Wenn Sie TESSERA_DASHBOARD_HOS T =0.0.0.0 für LAN-Zugriff setzen, wird jede /ap I/*-Route (Projektgraph, Pläne, gesperrte Entscheidungen) für jeden im Netzwerk ohne Login erreichbar – führen Sie dies nur in einem vertrauenswürdigen Netzwerk durch.

Token-Einsparungsziel

| Metrik | Ziel | | ------------------------ | ----------- ------- | | Turn 2+ Lese reduzierung | ≥50% Zeichen vs Kaltstart | | 10-Turn-Sitsung reduzierung | ≥40% gsamtze ichen | | Cache-Trefferqute (nach Turm 3) | ≥60% | | Symbolauszug- Ein sparungen | ≥70% vs Ganze datei-Lesung |

Claude Code In-Sitzungs-Skills

Tessera liefert fünf Claude Code Schrägstrich-Befehle, die den Tessera-Graphen für Kontext und die Codex CLI für GPTs Perspektive nützen. Der Plugin-Markplatz-Installierer installiert sie automatisch aus dem s kills/- Verzeichnis in diesem Repo. Für manuelle Installation führen Sie ./instal l.sh aus oder kopieren Sie aus skills/ nach ~/.claude/s kills/.

Erfordert: codex CLI (npm install -g @openai/codex) authentifiziert über codex auth login (ChatGPT-Abonnement) oder OPENAI_API_KEY.

Alle Skills degradieren an ständig, wenn Tessera MCP nicht konfiguriert ist – sie führen weiterhin Claude+GPT-Zusammenarbeit durch, nur ohne Graph-Kontext.

Lizenz

MIT