Tessera

Claude Code 向けの永続的なコードベースメモリ — オープンソース、ライセンスによる制限なし。

Tessera は Claude Code に、ターンやセッションを超えて持続するプロジェクトの意味的理解を与え、冗長なファイルの再読み込みを排除し、構造化されたアクション履歴を提供します。

仕組み

1. tessera scan . — コードベースの SQLite グラフを構築（ファイル、シンボル、インポート）

2. Claude は毎ターン graph_continue を呼び出し — キャッシュされスコア付けされたファイル推奨にルーティング

3. graph_register_edit は編集後にグラフを更新し、計画チェックリストを自動チェック

4. オプション: tessera debate "task" を実行して Claude 対 GPT の複数ラウンド計画討論

Related MCP server: RLM Memory MCP Server

インストール

Claude Code プラグイン（推奨）

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

これにより MCP サーバーが登録され（uvx 経由 — Python 環境不要）、すべてのスキル（/build、/debate、/cleanup、/plan-review、/codex-review）が自動インストールされます。その後、任意のプロジェクトで:

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

pip（手動 / CI）

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

claude CLI が存在する場合、スクリプトはプラグインマーケットプレイスを使用します（uvx 経由で MCP サーバーを登録し、すべてのスキルをインストール）。存在しない場合は pip install tessera にフォールバックし、スキルを ~/.claude/skills/ にコピーするよう提案します。

その後、任意のプロジェクトで:

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

手動の代替方法

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

クイックスタート

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 登録

tessera scan . の後、プロジェクトに .mcp.json が作成されます:

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

uvx は初回実行時に PyPI から tessera を取得してキャッシュします — PATH の設定は不要です。Claude Code が自動的に認識します。

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

討論モード

pip install tessera[debate] と codex CLI が必要です。

ChatGPT への接続（API キー不要）

ChatGPT Plus または Pro のサブスクリプションをお持ちの場合、codex CLI をそれで認証できます — 別途 API キーや課金設定は不要です:

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

これで完了です。tessera debate およびすべての Claude Code スキル（/debate、/build、/cleanup など）が自動的にサブスクリプションを使用します。

API キー経由の接続（オプション）

サブスクリプションの OAuth パスではなく直接 API 課金を希望する場合は OPENAI_API_KEY を設定してください。

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

機能フラグ

ダッシュボードはデフォルトで 127.0.0.1 にバインドされ、認証はありません。LAN アクセスのために TESSERA_DASHBOARD_HOST=0.0.0.0 を設定した場合、すべての /api/* ルート（プロジェクトグラフ、計画、ロックされた決定）がネットワーク上の誰でもログインなしでアクセス可能になります。 — 信頼できるネットワークでのみ行ってください。

トークン節約目標

Claude Code セッション内スキル

Tessera は5つの Claude Code スラッシュコマンドを提供します。これらはコンテキストに tessera グラフを使用し、GPT の視点に Codex CLI を使用します。プラグインマーケットプレイスのインストールは、このリポジトリの skills/ ディレクトリから自動インストールします。手動インストールの場合は、./install.sh を実行するか、skills/ から ~/.claude/skills/ にコピーしてください。

必要条件: codex CLI（npm install -g @openai/codex）を codex auth login（ChatGPT サブスクリプション）または OPENAI_API_KEY で認証済みであること。

すべてのスキルは、tessera MCP が設定されていない場合でもグレースフルデグラデーションします — グラフコンテキストなしで Claude+GPT のコラボレーションを実行します。

ライセンス

MIT