关于这个 mod

todo-bar：Claude Code 任务进度条

简体中文 · English

Claude 列出任务清单后，输入框上方会出现一条进度条：现在做到哪一项、这一项做了多久、总共完成了多少，一眼就能看到。它只读 Claude 本来就会发出的工具调用，不额外消耗 token。

功能

• 进度一目了然：第一行是正在做的任务、进度条、完成数和百分比，第二行列出接下来的一两项。
• 任务计时：一项任务做满 1 分钟后，后面会显示已用时间（如 3m 12s）；超过 slowMinutes（默认 10 分钟）变成黄色，卡住的步骤一眼就能看出来。
• 完成提示：全部完成后进度条变绿，显示整份清单的总用时，8 秒后自动收起；Claude 再列新清单时会重新出现。
• 零 token、零干扰：只在 TodoWrite、TaskCreate、TaskUpdate 执行完之后读取结果，不注册工具，不往系统提示词里加内容，也不拦截任何调用。被拒绝或失败的调用不计入，子代理自己的清单也不显示。
• 恢复会话不丢进度：每个会话的清单都会保存，恢复会话后进度条还在。
• 输入框弹出 / 或 @ 选择器时，进度条会暂时让开。

安装

claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install todo-bar@hoobnn-agent-mods

命令

• /todos：列出全部任务和状态（✓ 已完成、● 进行中、○ 等待中），以及每项的用时和期间的工具调用次数，例如 ✓ 编写测试 5m 20s · 工具调用 14 次。
• /todos off、/todos on：隐藏或显示进度条。这个设置会写回 /config，以后的会话也会沿用。

选项

在 /config 里修改，或写在 ~/.claude/settings.json 的 pluginConfigs 里：

| 选项 | 作用 | 默认 | | --- | --- | --- | | visible | 显示进度条（/todos off / on 改的就是它） | 开 | | showNext | 第二行显示接下来的一两项任务 | 开 | | slowMinutes | 当前任务做了多少分钟后时间变黄；0 表示不变色 | 10 | | language | 界面语言：auto、en、zh-Hans、zh-Hant、ja、ko、es、fr、de、pt-BR、ru | auto |

language 为 auto 时，依次跟随 Claude Code 的 language 设置和系统语言环境，都没有时用英语。

同系列 mod

hoobnn-agent-mods 里还有状态栏 HUD（hud）、回合回执（receipt）、运行动画和宠物（spinner）、Tailscale 节点状态（ts-band）和一言（hitokoto），可以搭配使用。

开发

• hooks/register.tsx：钩子（会话开始时的语言、/todos 和已保存的清单，读取工具调用，命令和横条）。
• hooks/board.ts：根据每次调用的内容生成进度条要画的清单。
• hooks/config.ts：选项，一次性读成类型化的 Config。
• hooks/i18n.ts：各语言文案。
• hooks/kit/：claude-code/kit 的副本；改源文件后运行 scripts/sync-kit.sh。