---
title: "todo-bar"
url: "https://claudemods.dev/zh-cn/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-cn"
content_locale: "zh-cn"
---

# 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`。
