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

# 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가 새 목록을 표시하면 다시 나타납니다.
- **토큰 0, 방해 0**: `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` | 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`: hook(세션 시작 시 언어, `/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`。
