---
title: "todo-bar"
url: "https://claudemods.dev/zh-tw/builds/todo-bar-9eca13"
source: "https://github.com/hoobnn/hoobnn-agent-mods/tree/main/claude-code/todo-bar"
source_type: "github"
repo: "https://github.com/hoobnn/hoobnn-agent-mods/tree/main/claude-code/todo-bar"
author: "hoobnn"
author_handle: "hoobnn"
stars: 8
category: "用量與成本"
categories: ["cost"]
tags: ["Claude Code", "mod"]
permission_level: 2
scan_complete: false
install: "claude plugin marketplace add hoobnn/hoobnn-agent-mods\nclaude plugin install todo-bar@hoobnn-agent-mods"
added: "2026-10-04T10:40:36.607Z"
updated: "2026-11-09T14:28:07Z"
locale: "zh-tw"
content_locale: "zh-tw"
---

# todo-bar

todo-bar：從 todo 與 task 工具本身的呼叫讀取任務清單，在提示列上方以橫條顯示進度，不需要額外工具。

## Description

# todo-bar：在 Claude Code 中顯示任務進度條

**繁體中文** · [English](README.en.md)

Claude 列出任務清單後，輸入框上方會出現進度條：目前做到哪一項、這項花了多久、總共完成多少，一眼就能看見。它只讀取 Claude 本來就會發出的工具呼叫，不額外消耗 token。

![todo-bar：進行中的任務、已用時間、進度條和接下來的任務](assets/preview.png)

## 功能

- **進度一目瞭然**：第一行顯示目前任務、進度條、完成數與百分比，第二行列出接下來的一兩項。
- **任務計時**：一項任務做滿 1 分鐘後，後面會顯示已用時間（例如 `3m 12s`）；超過 `slowMinutes`（預設 10 分鐘）後變成黃色，卡住的步驟很容易看出來。
- **完成提示**：全部完成後進度條變綠，顯示整份清單的總用時，8 秒後自動收起；Claude 再列出新清單時會重新出現。
- **零 token、零干擾**：只在 `TodoWrite`、`TaskCreate`、`TaskUpdate` 執行完後讀取結果，不註冊工具、不往系統提示新增內容，也不攔截任何呼叫。被拒絕或失敗的呼叫不計入，子代理自己的清單也不顯示。
- **恢復工作階段不丟進度**：每個工作階段的清單都會儲存，恢復後進度條仍然在。
- 輸入框彈出 `/` 或 `@` 選擇器時，進度條會暫時讓開。

![todo-bar：所有任務完成](assets/done.png)

## 安裝

```
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](../../README.md) 中還有狀態列 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`。

## Install

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

## Original README

# todo-bar：Claude Code 任务进度条

**简体中文** · [English](README.en.md)

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

![todo-bar：正在进行的任务、已用时间、进度条和接下来的任务](assets/preview.png)

## 功能

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

![todo-bar：全部任务完成](assets/done.png)

## 安装

```sh
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](../../README.md) 里还有状态栏 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`。
