hoobnn/hoobnn-agent-mods/tree/main/claude-code/todo-bar

todo-bar: todo 및 task 도구가 직접 보낸 호출에서 작업 목록 진행률을 읽어 프롬프트 위의 막대에 표시하며 추가 도구가 필요하지 않습니다.
hoobnn/hoobnn-agent-mods/tree/main/claude-code/todo-bar

한국어 · English
Claude가 작업 목록을 표시하면 입력창 위에 진행률 표시줄이 나타납니다. 현재 항목, 그 항목에 걸린 시간, 전체 완료 수를 한눈에 볼 수 있습니다. Claude가 원래 보내는 도구 호출만 읽으므로 token을 추가로 사용하지 않습니다.

3m 12s)이 표시됩니다. slowMinutes(기본 10분)를 넘으면 노란색으로 바뀌어 멈춘 단계를 쉽게 찾을 수 있습니다.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 | 둘째 줄에 다음 한두 작업 표시 | 켜짐 |
| 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 설정과 시스템 언어 환경을 차례로 따르며, 둘 다 없으면 영어를 사용합니다.
hoobnn-agent-mods에는 상태 표시줄 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를 실행합니다.먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.
claude plugin marketplace add hoobnn/hoobnn-agent-mods claude plugin install todo-bar@hoobnn-agent-mods
简体中文 · English
Claude 列出任务清单后,输入框上方会出现一条进度条:现在做到哪一项、这一项做了多久、总共完成了多少,一眼就能看到。它只读 Claude 本来就会发出的工具调用,不额外消耗 token。

3m 12s);超过 slowMinutes(默认 10 分钟)变成黄色,卡住的步骤一眼就能看出来。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 | 第二行显示接下来的一两项任务 | 开 |
| slowMinutes | 当前任务做了多少分钟后时间变黄;0 表示不变色 | 10 |
| language | 界面语言:auto、en、zh-Hans、zh-Hant、ja、ko、es、fr、de、pt-BR、ru | auto |
language 为 auto 时,依次跟随 Claude Code 的 language 设置和系统语言环境,都没有时用英语。
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。내 프로젝트인가요? 이 배지를 README나 웹사이트에 넣으면 이 페이지로 연결됩니다.