この mod について
todo-bar: Claude Code タスク進捗バー
簡体字中国語 · English
Claude がタスクリストを列挙した後、入力ボックスの上に進捗バーが表示されます。現在どの項目を進めているか、その項目にどれだけ時間がかかったか、合計でどれだけ完了したかが一目でわかります。Claude が本来発行するツール呼び出しを読むだけで、追加の token を消費しません。
機能
- 進捗が一目でわかる: 1 行目には進行中のタスク、進捗バー、完了数と割合が表示され、2 行目には次に行う 1〜2 項目が列挙されます。
- タスクの計時: タスクを 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 | 2 行目に次の 1〜2 件のタスクを表示 | オン |
| 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 には、ステータスバー 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を実行します。
