BUKOWSKIREAL/trace

Trace — a local, background version tracker for multi-CLI-agent coding workflows (Claude Code, Codex, Cursor, ...). Content-addressed snapshots in SQLite, per-agent attribution, diff/restore/revert vi

About trace

Trace 是一个面向 AI 编程协作场景的本地版本追踪工具。它不替代 Git，而是补充 Git：当你同时使用 Claude Code、Codex CLI、Cursor、OpenCode 等工具修改同一个项目时，Trace 会在本地记录“哪个 agent 在什么时候改了哪些文件”，并把每次变化保存成可以查看 diff、恢复文件、撤销某个 agent 修改的快照。

Trace 现在是一个纯 Python + Textual TUI 产品：一个命令同时启动后台 watcher 和终端界面，退出 TUI 即停止追踪。

- 看得清来源：区分人类手动修改、Claude、Codex、Cursor 等不同来源的文件变化。 - 找得到过程：把短时间内连续发生的文件变化合并成一次版本记录，方便回看每一步。 - 能安全恢复：在 Textual TUI 中查看 diff，并把单个文件或某个 agent 的修改恢复到之前状态。

捕获文件变化 → 过滤噪声 → 等待文件稳定 → 通过 MCP/活动/transcript/进程证据归因 → 按 agent 防抖批量提交 → 持久化到 SQLite 与内容寻址 blob → Textual TUI 进程内读取展示。

如果不传 --workspace，Trace 会优先使用上次记录的工作区；没有记录时会打开 Textual 内置目录选择器。

- Commits：查看时间线、每次提交的文件 diff、恢复单个文件、修正低置信归因。 - Agents：查看 agent 活动统计，预览并撤销某个 agent 的文件级贡献。 - Workspace：查看当前工作区、数据库路径、commit/snapshot/agent 计数。 - MCP：检查 Codex、Claude Code、OpenCode 等配置状态，并执行一键安装。

Trace 支持文本、Office 文档、PDF、图片和未知二进制文件的版本记录；常见文本和文档格式会显示更友好的 diff 摘要。

Trace 提供一个本地 stdio MCP server，供 Codex、Claude Code、Cursor、OpenCode 等 agent 主动申报自己改过的文件。Codex 还可以配套安装 Trace hooks，在 PreToolUse / PostToolUse 阶段自动记录 applypatch、Write、Edit 和 Bash 产生的文件变化，避免多个 agent 同时运行时只能被动猜测归属。

申报记录会写入 workspace 的 .trace/traceactivity.jsonl，归因器会优先使用这些记录；没有申报时才回退到 transcript / 进程扫描。

Claude Code CLI：项目根目录的 .mcp.json 会被自动读取，无需额外配置。

或手动配置，在全局 MCP 配置文件中添加；Windows 可把 command 改成 py：

也可以在 TUI 的 MCP 视图中使用一键安装，它会替换旧的 trace section，避免 workspace 指向旧路径。详细配置和故障排除请参考 MCPSETUP.md。

- tracerecordfiles(agent, files, operation="write", confidence=1.0)

agent 每次写文件前后调用一次即可，例如把 agent 设为 codex、claude、cursor，files 传 workspace 相对路径或绝对路径列表。

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/BUKOWSKIREAL--trace.html)

Related MCP servers