
Pentimento 发布:为 AI 编码代理的计划文件提供状态与溯源管理
来源标题:Show HN: Pentimento – status and lineage for your coding agent's plan files
Pentimento 是一款为 Claude Code、Cursor 和 Antigravity 生成的计划文件提供状态追踪与溯源的工具。它从文件名无规律、不含状态信息的计划文件中推导出状态,并通过 CLI 支持列出、筛选和以谱系树形式渲染。用户可通过 pip install pentimento 安装,并用 AGENT_PLANS_DIR 指定计划目录。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
为 Claude Code、Cursor 和 Antigravity 的计划文件提供状态、意图与血缘信息。
Claude Code、Cursor 和 Antigravity 会留下计划文件。累积到几百个之后,你就分不清哪些已经完成、哪些你还在意、哪个计划替换了哪个——文件名是随机的,文件本身也不说明自己的状态。pentimento 推导出这些状态,并提供一个 CLI,让你列出、筛选,并把它们渲染成一棵血缘树。
有三类计划值得再次找到:
用 harness 工程的说法,计划就是状态层:一个会话留给下一个会话的东西。pentimento hook 在 agent 写入时让该状态保持最新,prior-plans 技能则让 agent 把它读回来。
pentimento 指一幅重绘的油画下透出的早期画作;计划目录正是如此。
pip install pentimento
或从源码安装:
pip install git+https://github.com/kjiwa/pentimento.git
bash、zsh 和 fish 的 Tab 补全在 docs/reference.md#shell-completion。
将 AGENT_PLANS_DIR 指向你的计划目录(默认是 ~/.claude/plans),然后:
pentimento list # 查看语料库;派生字段无需回填即可显示 pentimento backfill # 持久化派生字段,使其比 transcript 存留更久 pentimento set some-plan-id --intent active pentimento list --starred
要暂存一个你打算回头再看的已完成计划,给它打标签并设置意图,之后按标签找到它:
pentimento set some-plan-id --add-tag auth --intent someday pentimento list --tag auth
要按血缘而不是按标签拉出一条子计划线索:
pentimento tree some-plan-id pentimento tree some-plan-id --ancestors
要查明某个早期决策是如何做出的,可跨所有项目搜索标题(或标题和正文),然后重新打开该计划;要查看你最近完成了什么,可按日期筛选:
pentimento list --title 'github actions|\bGHA\b' pentimento list --grep 'concurrency group' --status complete pentimento show some-plan-id --full pentimento list --status complete --since 1w
docs/workflows.md 会端到端地逐一演示这些操作。
各来源及其默认目录见 docs/integrations.md;Cursor 和 Antigravity 的规则与注意事项见 Cursor 和 Antigravity 两节。
下面的示例由 sh demo/capture.sh 重新生成。
PLAN 显示短 id,例如 api-auth-rollout 的短 id 是 auth-rollout。--columns(或 PENTIMENTO_COLUMNS)选择显示哪些列以及它们的顺序;见 Columns。
list 和 tree 共用筛选条件,列在 synopsis 中。
PLAN STATUS INTENT PROJECT SOURCE TITLE TAGS CREATED UPDATED style-guide superseded abandoned platform claude Write a docs style guide 2026-07-31 6w auth-redesign complete abandoned platform claude Redesign the auth API [auth, +1] 2026-08-05 5w dunning-copy complete someday billing claude Rewrite dunning email copy [billing] 2026-08-20 3w auth-rollout partial active platform claude Roll out the new auth API [auth, +1] 2026-08-25 2w auth-cleanup not-started queued platform claude Remove the old auth API [auth, +1] 2026-08-30 2w auth-docs not-started unset platform claude Document the new auth API 2026-09-02 1w invoice-retry unknown unset billing claude Retry failed invoice charges [billing] 2026-09-04 1w relevance-tuning not-started active billing claude Tune search relevance [search] 2026-09-09 5d onboarding-checklist not-started unset claude Write the onboarding checklist 2026-09-13 1d 9 plans
低于表格阈值时,list 会把每个计划堆叠成一条记录;见 layout rule。
Write a docs style guide style-guide superseded abandoned platform claude 2026-07-31 6w Redesign the auth API auth-redesign complete abandoned platform claude [auth, security] 2026-08-05 5w Rewrite dunning email copy dunning-copy complete someday billing claude [billing] 2026-08-20 3w Roll out the new auth API auth-rollout partial active platform claude [auth, security] 2026-08-25 2w Remove the old auth API auth-cleanup not-started queued platform claude [auth, security] 2026-08-30 2w Document the new auth API auth-docs not-started unset platform claude 2026-09-02 1w Retry failed invoice charges invoice-retry unknown unset billing claude [billing] 2026-09-04 1w Tune search relevance relevance-tuning not-started active billing claude [search] 2026-09-09 5d Write the onboarding checklist onboarding-checklist not-started unset claude 2026-09-13 1d 9 plans
tree 计划嵌套在其父计划下,按项目分组。plain tree 这样渲染整个语料库;tree <id> 则以一个计划为根——该计划及其下的所有内容(见 tree <id>)。--ancestors 还会向上走到 <id> 的最顶层祖先,仅沿主干,用于从更大的森林中拉出单条线索。
(no project)
-- Write the onboarding checklist onboarding-checklist not-started unset 2026-09-13 1d billing |-- Rewrite dunning email copy | dunning-copy complete someday [billing] 2026-08-20 3w |-- Retry failed invoice charges | invoice-retry unknown unset [billing] 2026-09-04 1w (parent elided: no-such-plan) -- Tune search relevance
relevance-tuning not-started active [search] 2026-09-09 5d
platform
|-- Write a docs style guide
| style-guide superseded abandoned 2026-07-31 6w
-- Redesign the auth API auth-redesign complete abandoned [auth, security] 2026-08-05 5w -- Roll out the new auth API
auth-rollout partial active [auth, security] 2026-08-25 2w
|-- Remove the old auth API
| auth-cleanup not-started queued [auth, security] 2026-08-30 2w
`-- Document the new auth API
auth-docs not-started unset [auth, security] 2026-09-02 1w
9 plans
platform
-- Redesign the auth API auth-redesign complete abandoned [auth, security] 2026-08-05 5w -- Roll out the new auth API
auth-rollout partial active [auth, security] 2026-08-25 2w
|-- Remove the old auth API
| auth-cleanup not-started queued [auth, security] 2026-08-30 2w
`-- Document the new auth API
auth-docs not-started unset [auth, security] 2026-09-02 1w
show
Roll out the new auth API
id: api-auth-rollout path: ~/.claude/plans/api-auth-rollout.md
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。