Skip to main content
Glama
deenesjakoruzh
dr-code

tessera

by dr-code
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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 密钥连接（可选）

如果你更喜欢直接 API 计费而不是订阅 OAuth 路径，请设置 OPENAI_API_KEY。

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

功能标志

标志

默认值

效果

TESSERA_ENABLE_DEBATE

开启

启用 tessera debate

TESSERA_ENABLE_DASHBOARD

开启

启用 tessera dashboard

TESSERA_ENABLE_COMPLIANCE

开启

启用 tessera verify

仪表盘默认绑定到 127.0.0.1 且无身份验证。如果你设置 TESSERA_DASHBOARD_HOST=0.0.0.0 用于局域网访问，每个 /api/* 路由（项目图、计划、锁定决策）都将对网络上的任何人开放，无需登录——仅在受信任的网络上执行此操作。

Token 节省目标

指标

目标

第2轮及之后读取减少

相比冷启动减少 ≥50% 字符

10轮会话减少

总字符减少 ≥40%

缓存命中率（第3轮后）

≥60%

符号摘录节省

相比全文件读取减少 ≥70%

Claude Code 会话内技能

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 认证。

技能

用法

描述

/debate

/debate "REST vs GraphQL"

Claude 与 GPT 关于架构或设计决策的多轮辩论

/build

/build "add JWT auth"

完整构建循环：GPT 规划 → 辩论 → 用户批准 → 实现 → GPT 审查

/cleanup

/cleanup src/

双向杂乱扫描器 — Claude + GPT 独立分析，然后协调

/plan-review

/plan-review plan.md

在编码前将实现计划发送给 GPT 进行结构化审查

/codex-review

/codex-review HEAD~2

对暂存更改、提交或文件进行独立的 GPT 代码审查

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

许可证

MIT

This server cannot be deployed

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers