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

# todo-bar

todo-bar：todo と task ツール自身の呼び出しからタスクリストの進捗を読み取り、プロンプト上部のバーに表示します。追加のツールは不要です。

## Description

# todo-bar：Claude Code のタスク進捗バー

**日本語** · [English](README.en.md)

Claude がタスクリストを表示すると、入力欄の上に進捗バーが現れます。現在の項目、そこにかかった時間、全体の完了数を一目で確認できます。Claude がもともと送るツール呼び出しだけを読み取り、token を追加消費しません。

![todo-bar：進行中のタスク、経過時間、進捗バー、次のタスク](assets/preview.png)

## 機能

- **進捗が一目でわかる**：1 行目に現在のタスク、進捗バー、完了数、割合を表示し、2 行目に次の 1〜2 項目を表示します。
- **タスクの計時**：タスクが 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` が変更する値） | on |
| `showNext` | 2 行目に次の 1〜2 タスクを表示 | on |
| `slowMinutes` | 現在のタスクが何分続くと時間を黄色にするか。0 は色を変えない | 10 |
| `language` | UI 言語：`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`。
