ClaudeMods
☰
KO
● — 명 접속 중 · 조회 — 회
후원프로젝트 제출
GitHub 저장소 · 작성자 hoobnn

todo-bar

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

hoobnn@hoobnn

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

이미지1
번역 완료

이 mod 소개

todo-bar: Claude Code 작업 진행률 표시줄

한국어 · English

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

todo-bar: 진행 중인 작업, 경과 시간, 진행률 표시줄과 다음 작업

기능

  • 진행 상황을 한눈에 확인: 첫째 줄에는 현재 작업, 진행률 표시줄, 완료 수와 백분율을 표시하고 둘째 줄에는 다음 한두 항목을 표시합니다.
  • 작업 시간 측정: 작업이 1분 동안 진행되면 뒤에 경과 시간(예: 3m 12s)이 표시됩니다. slowMinutes(기본 10분)를 넘으면 노란색으로 바뀌어 멈춘 단계를 쉽게 찾을 수 있습니다.
  • 완료 알림: 모두 완료되면 표시줄이 녹색으로 바뀌고 전체 목록에 걸린 시간을 보여 준 뒤 8초 후 자동으로 접힙니다. Claude가 새 목록을 표시하면 다시 나타납니다.
  • 토큰 0, 방해 0: TodoWrite, TaskCreate, TaskUpdate 실행이 끝난 뒤에만 결과를 읽고, 도구를 등록하지 않으며, 시스템 프롬프트에 내용을 추가하거나 호출을 가로채지 않습니다. 거부되거나 실패한 호출은 세지 않고 하위 에이전트의 목록도 표시하지 않습니다.
  • 세션을 복원해도 진행률 유지: 각 세션의 목록을 저장하므로 세션을 복원한 뒤에도 표시줄이 남습니다.
  • 입력창에 / 또는 @ 선택기가 열리면 진행률 표시줄이 잠시 비켜납니다.

todo-bar: 모든 작업 완료

설치

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에는 상태 표시줄 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
원문 / README

todo-bar:Claude Code 任务进度条

简体中文 · English

Claude 列出任务清单后,输入框上方会出现一条进度条:现在做到哪一项、这一项做了多久、总共完成了多少,一眼就能看到。它只读 Claude 本来就会发出的工具调用,不额外消耗 token。

todo-bar:正在进行的任务、已用时间、进度条和接下来的任务

功能

  • 进度一目了然:第一行是正在做的任务、进度条、完成数和百分比,第二行列出接下来的一两项。
  • 任务计时:一项任务做满 1 分钟后,后面会显示已用时间(如 3m 12s);超过 slowMinutes(默认 10 分钟)变成黄色,卡住的步骤一眼就能看出来。
  • 完成提示:全部完成后进度条变绿,显示整份清单的总用时,8 秒后自动收起;Claude 再列新清单时会重新出现。
  • 零 token、零干扰:只在 TodoWrite、TaskCreate、TaskUpdate 执行完之后读取结果,不注册工具,不往系统提示词里加内容,也不拦截任何调用。被拒绝或失败的调用不计入,子代理自己的清单也不显示。
  • 恢复会话不丢进度:每个会话的清单都会保存,恢复会话后进度条还在。
  • 输入框弹出 / 或 @ 选择器时,进度条会暂时让开。

todo-bar:全部任务完成

安装

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 里还有状态栏 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나 웹사이트에 넣으면 이 페이지로 연결됩니다.

Featured on ClaudeMods
크기
테마
Markdown
HTML

비슷한 프로젝트