關於這個 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。




