AI 代码的 git blame,精确到 agent session
针对 agent session 的 git blame
指向你的 agent 写下的某一行。阅读写下它的那个 session。
git blame 通常止步于一个 commit 和一个名字,而那个名字往往是你自己。KeepPlain 会顺着这一行,追踪到它背后的 Claude Code、Codex、Cursor、Pi 或 Antigravity session,并打开那一轮对话:你当时要求了什么、agent 先尝试了什么、后来为什么改掉。
curl -fsSL https://keepplain.com/install.sh | sh # macOS and Linux
irm https://keepplain.com/install.ps1 | iex # Windows, in PowerShell
keepplain login
keepplain enable
个人使用免费。当 keepplain enable 询问是否要安装 git hooks 时,选择同意:它们会把该 session 的 id 加进你的 commit,blame 便能顺着它找到来源。
在 Windows 上,你也可以从 Microsoft Store 获取。
离开你电脑的内容 GitHub 上的插件
$ keepplain blame -L 35,47 src/auth/login.ts
no session found 35 │ // Five tries a minute, then a cool-down.
● Cursor · Scaffold the auth module 36 │ export const LOGIN_WINDOW = 60;
37 │
38 │ export const loginLimit = RateLimiter.for('login', (req) => {
no session found 39 │ if (req.isInternal()) return Limit.none();
40 │
○ Codex · Audit log for auth 41 │ audit('login.throttle', req);
● Claude Code · Rate-limit the login… 42 │ return Limit.perMinute(5).by(req.input('email'));
● Cursor · Scaffold the auth module 43 │ });
Git 能说出是谁改的,却说不出为什么改。
向你的 agent 询问某一行,它会顺着 git 找到做出这次改动的那个 session,读取从你提出要求到最终 commit 之间的每一轮对话,并附上原文引用作答。它会说明自己读了哪几轮,以及这个 session 是如何被找到的。
> why is line 42 of src/auth/login.ts keyed by account?
Deliberate. On Sep 30 the agent first keyed the limit by IP, and 2 of 41
tests failed: behind the load balancer every user shares one address.
You said:
“Behind the load balancer everyone has the same IP. Key it by the account.”
It switched the key to the email being signed in to and committed a3f9e1c.
quoted from turns 112–115 of your Claude Code session
你的 agent 的回答,在五种 agent 中皆可。
用大白话提问。不用学新命令。
当某个 prompt 问到代码的来历时,插件会往里面加一行:git 显示改了什么,做出这次改动的 session 显示为什么改。于是 agent 会先运行 git log 或 git blame,再凭 commit、它的 trailer、它的 subject 以及相关文件,向 KeepPlain 查询对应的 session。匹配在你的电脑上完成;这个 prompt 不会发送到任何地方。
> why is line 42 of src/auth/login.ts keyed by account?
> where did the retry loop in sync.ts come from?
> why was commit e93b2aa made?
> who added the lock in syncSeats, and why?
> откуда взялся этот таймаут?
人们实际会打的话。英语和俄语都行。
在网站上,某一行的链接会展开它的完整身世。
git blame 只显示最后一个 commit。在团队的搜索中,以 #L42 结尾的 GitHub 链接会变成这一行的历史:添加它的那个 commit、改动过它的每一个 commit,以及它们各自背后的 session。
团队记忆的运作方式
https://github.com/acme/api/blob/main/src/auth/login.ts#L42
| Commit | Line 42 | Session |
|---|---|---|
| 1b07c44 Sep 2 Add login throttle | Limit.perMinute(10).by(req.ip()) | Cursor · Scaffold the auth module. Made it. |
| 6d12f9a Sep 15 Tighten login limit | Limit.perMinute(5).by(req.ip()) | No session found. No trailer, and no agent edited the file before this commit. |
| a3f9e1c Sep 30 Key login rate limit by account | Limit.perMinute(5).by(req.input('email')) | Claude Code · Rate-limit the login endpoint. Made it. Codex · Audit log for auth. Only saw it: open in the same repository at the time, didn’t change this line. |
在 pull request 上,面向团队。
文章标题:Show HN: 为 AI 代码做 Git blame,精确到 agent 会话
正文: 为你的团队开启后,GitHub App 会在每个 pull request 上保留一条评论,并随着提交变化而更新:哪些提交来自某个会话,哪些是 agent 辅助完成的,以及每个提交背后的会话。
- 默认关闭,直到团队所有者开启。
- 私有仓库中只显示会话标题。在公开仓库中,链接会打开团队页面,仅成员可见。
- 评论中不包含 prompt、文本或文件。
它在 pull request 上的工作方式
keepplain bot · 已评论,2 分钟前编辑
此 pull request 背后的会话。那些来自某个 agent 会话或在 agent 帮助下完成的提交。
| Commit | Message | How | Session |
|---|---|---|---|
| 1b07c44 | Add login throttle | In a session | Scaffold the auth module |
| a3f9e1c | Key login rate limit by account | In a session | Rate-limit the login endpoint |
| 0f3e2b8 | Audit failed attempts | Agent-assisted | Audit log for auth |
它如何追踪一行
没有新的版本控制系统,也没有 IDE 扩展。你已经在使用的 agent 运行 git,然后询问 KeepPlain。
- 这一行的完整历史 git blame 只指出最后一个提交。你的 agent 向 git 询问所有触及该行的提交,最多八个。$ git log -L 42,42:src/auth/login.ts -s --date=short \ --format='%h %ad %s %(trailers:key=Agent-Session,valueonly)' a3f9e1c 2026-09-30 Key login rate limit by account 7c21e0b4-… 6d12f9a 2026-09-15 Tighten login limit 1b07c44 2026-09-02 Add login throttle 91e5aa20-… 三个提交触及了第 42 行。其中两个提交指明了它们来自哪个会话。
这一行的完整历史
git blame 只指出最后一个提交。你的 agent 向 git 询问所有触及该行的提交,最多八个。
$ git log -L 42,42:src/auth/login.ts -s --date=short \
--format='%h %ad %s %(trailers:key=Agent-Session,valueonly)'
a3f9e1c 2026-09-30 Key login rate limit by account 7c21e0b4-…
6d12f9a 2026-09-15 Tighten login limit
1b07c44 2026-09-02 Add login throttle 91e5aa20-…
三个提交触及了第 42 行。其中两个提交指明了它们来自哪个会话。
- 提交指明了它的会话 在提交信息中有一行 trailer,当某个提交包含某个会话的工作时,由 KeepPlain 的 prepare-commit-msg hook 写入。只有 id 会随你的 push 一起传输。会话本身不会。$ git show -s --format=%B a3f9e1c Key login rate limit by account Agent-Session: 7c21e0b4-2f6e-4a1d-9c3b-58e0f1d2a7b9
提交指明了它的会话
在提交信息中有一行 trailer,当某个提交包含某个会话的工作时,由 KeepPlain 的 prepare-commit-msg hook 写入。只有 id 会随你的 push 一起传输。会话本身不会。
$ git show -s --format=%B a3f9e1c
Key login rate limit by account
Agent-Session: 7c21e0b4-2f6e-4a1d-9c3b-58e0f1d2a7b9
- KeepPlain 找到会话 通过提交、trailer、主题和文件,在你来自全部五个 agent 的会话以及你团队的会话中进行搜索。search_my_work commit a3f9e1c agent_sessions 7c21e0b4-… subject "Key login rate limit by account" paths src/auth/login.ts → Claude Code · “Rate-limit the login endpoint” · Sep 30 found_by commit own true cursor turn 115 changed src/auth/login.ts, made a3f9e1c request turn 112 “Behind the load balancer everyone has…”
KeepPlain 找到会话
通过提交、trailer、主题和文件,在你来自全部五个 agent 的会话以及你团队的会话中进行搜索。
search_my_work
commit a3f9e1c
agent_sessions 7c21e0b4-…
subject "Key login rate limit by account"
paths src/auth/login.ts
→ Claude Code · “Rate-limit the login endpoint” · Sep 30
found_by commit own true
cursor turn 115 changed src/auth/login.ts, made a3f9e1c
request turn 112 “Behind the load balancer everyone has…”
文章标题:Show HN: Git blame for AI code, down to the agent session
正文:
- 它读取的是轮次 从你的请求到改动:其中的推理和你的决定,而不是整个日志。请求是你在改动前最后一次真实的请求;“yes”或“continue”会被跳过。get_session_excerpt 轮次 109–115 109 agent 按 IP 给限流器做键,这是常见的默认做法。110 tests ✕ 41 个中 2 个失败 · 同一个代理后面的用户会被一起封禁 112 you “在负载均衡器后面,所有人的 IP 都一样。按账号来做键。” 115 agent 改动了 src/auth/login.ts:42 · 提交了 a3f9e1c
它读取的是轮次
从你的请求到改动:其中的推理和你的决定,而不是整个日志。请求是你在改动前最后一次真实的请求;“yes”或“continue”会被跳过。
get_session_excerpt turns 109–115
109 agent Keying the limiter by IP, the usual default.
110 tests ✕ 2 of 41 failed · users behind one proxy are blocked together
112 you “Behind the load balancer everyone has the same IP. Key it by the account.”
115 agent changed src/auth/login.ts:42 · committed a3f9e1c
- 你的 agent 会作答,并附上引用 上方的答案:发生了什么、你的原话、那次提交,以及它来自哪些轮次。如果这个会话是通过其他方式找到的——靠它的编辑记录找到的,或者根本没找到——答案也会说明这一点。
你的 agent 会作答,并附上引用
上方的答案:发生了什么、你的原话、那次提交,以及它来自哪些轮次。如果这个会话是通过其他方式找到的——靠它的编辑记录找到的,或者根本没找到——答案也会说明这一点。
当线索断了,它会说出来
答案会告诉你这个会话是如何被找到的。或者告诉你它没被找到。
靠提交找到的
提交会说明它来自哪个会话。答案会引用那个会话,以及它读取的轮次。
靠编辑记录找到的
没有 trailer?KeepPlain 会取该 agent 在提交之前对这些文件的最后几次编辑,答案会说明它是这样找到的,而不是靠提交找到的。
队友的会话
你会知道这是谁的会话,以及它的页面。对话内容会一直留在作者那里,直到他们主动分享。
没有找到 agent 会话
这项改动并不是在一个你可以读取的、已同步的会话中完成的。你的 agent 会如实说明,而不是编造一个理由。
什么会离开你的电脑
Git 在你的电脑上运行,代码就留在那里。
网站会收到什么
文件的路径及其提交:哈希、每次提交中该文件的名称、标题、Agent-Session trailer、日期。一个文件最新的 300 次提交,每次请求一百个。绝不包含代码。
会返回什么
你可以读取的会话。队友的会话你会在团队列表中看到,但无权读取,只会显示其作者的名字。
未登录
如果一个 trailer 指向的会话并不在网站上,它会在本机上查找,且它的任何内容都不会发往任何地方。未登录时,你只能得到这些,其余部分只有提交的标题。
git 钩子
只在你对 keepplain enable 说过 yes 的那个仓库里生效,绝不会全局生效。会话 id 会成为该仓库历史的一部分:在公开仓库里,所有人都能看到它。keepplain disable 会移除这些钩子;已经写进提交里的 trailer 会保留。
选项
-L from,to 只 blame 这些行,--rev=commit 查看该文件当时的样子,-w 忽略空白,--json 用于脚本和桌面应用。
阅读代码
这个插件采用 MIT 许可证。它的 README 描述了该命令,“什么会离开你的机器”下面的表格列出了每一次调用。
实测,而非承诺
用做出改动的那个会话来回答“why”问题
“why”问题的答案中位数
Claude Code、Codex、Cursor、Pi 和 Antigravity
安装时 KeepPlain 会主动引入的过往会话数量
2026 年 10 月 14 日在生产环境中实测:创始人就自己的工作提出了 34 个问题,其中 6 个是“why”,覆盖 391 个会话。34 个中有 31 个,正确的会话排在第一位。这是一个人的历史记录,不是基准测试。
下次,问问为什么。
curl -fsSL https://keepplain.com/install.sh | sh # macOS and Linux
irm https://keepplain.com/install.ps1 | iex # Windows, in PowerShell
keepplain login
keepplain enable
文章标题:Show HN: 为 AI 代码做 Git blame,精确到 agent 会话
正文: 然后执行 keepplain login 和 keepplain enable,在 git hooks 提示处选择 yes 以启用 trailer。对文件执行 blame:keepplain blame <file>。
在 Windows 上,你也可以从 Microsoft Store 获取它。
问题与反馈:[email protected]
KeepPlain 中还有更多内容
为你准备 免费
- 某一行为何变更你在这里
- 跨 agent 的记忆你的 agent 会找到你已经解决过的问题,并在任何 agent 中接手该任务。
- 接近限额时交接当你接近 Claude 限额时,可以带着在你机器上生成的简报,在 Codex 或 Pi 中继续。
- 来自你纠正的规则在两次对话中纠正它,添加规则,然后你使用的每个 agent 都会读到它。
- 两分钟了解会话把数小时的 agent 工作浓缩为关键时刻,并附上每一轮的代码。
- 默认私密机密会在你的机器上移除。除非你确认发布,否则不会发布任何内容。
为你的团队准备 按活跃席位计费
- 团队规则,经过审阅你的团队像审阅 pull request 一样审阅的规则,会传达给团队中的每个 agent。
- 团队记忆agent 会先搜索团队的会话,而且即使人员离开,工作成果也会保留。
- pull request 上的会话每个 pull request 都会显示哪些提交来自某个会话,并链接到该会话。
- 洞察agent 时间花在哪里、哪些内容被合并,以及成本是多少。
为所有人准备 免费
- 会话库按技术栈和任务展示真实会话,包括 agent 出错的地方。
- 为你的 agent 提供 MCP在任务开始前,或当它卡住时,你的 agent 会查看其他人是如何解决它的。
- 来自会话的技能把一次成功的会话转化为技能、规则或提示词。
- 比较运行结果将同一提示词的两到四次运行并排比较,基于同一时间轴。
- 分享你的构建过程把你构建过程的会话附在 pull request 或 README 中,细节程度由你选择。