tessera (Dr Code)

镶嵌物

Claude Code的持久代码库内存——开源，无许可证门控。

Tessera为Claude Code提供了对项目的语义理解，该理解在各个回合和会话中持续存在，消除了冗余的文件重新读取，并提供了结构化的操作历史。

运作原理

1. tessera scan . --构建代码库（文件、符号、导入）的SQLite图
2. 克劳德打电话来 graph_continue 每一个转折点——缓存、评分文件推荐的路线
3. graph_register_edit 编辑后更新图表，自动检查计划清单
4. 可选：运行 tessera debate "task" 克劳德vs GPT多轮规划辩论

安装

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存在，脚本使用插件市场（通过注册MCP服务器 uvx 并安装所有技能）。没有它，它就会倒退 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获取并缓存镶嵌体——不需要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密钥连接（可选）

集 OPENAI_API_KEY 如果您更喜欢直接API计费而不是订阅OAuth路径。

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

功能标志

代币节省目标

Claude会话中的代码技能

Tessera提供了五个Claude Code斜线命令，这些命令使用Tessera图作为上下文，使用Codex CLI作为GPT的视角。插件市场安装会自动从以下位置安装它们 skills/ 此仓库中的目录。对于手动安装，请运行 ./install.sh 或复制自 skills/ 到 ~/.claude/skills/.

要求： codex CLI(npm install -g @openai/codex)通过身份验证 codex auth login （ChatGPT订阅）或 OPENAI_API_KEY.

当未配置tessera MCP时，所有技能都会优雅地降级——它们仍然运行Claude+GPT协作，只是没有图上下文。

许可证

麻省理工学院