이 mod 소개
todo-bar: Claude Code 작업 진행률 표시줄
중국어 간체 · English
Claude가 작업 목록을 나열한 후 입력 상자 위에 진행률 표시줄이 나타납니다. 지금 어떤 항목을 하고 있는지, 이 항목에 얼마나 걸렸는지, 총 얼마나 완료했는지 한눈에 볼 수 있습니다. Claude가 원래 보내는 도구 호출만 읽으며 추가 token을 소비하지 않습니다.
기능
- 진행 상황을 한눈에: 첫 번째 줄은 진행 중인 작업, 진행률 표시줄, 완료 수와 백분율을 보여 주고, 두 번째 줄은 다음 한두 항목을 나열합니다.
- 작업 타이머: 작업을 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 | 두 번째 줄에 다음 한두 작업 표시 | 켜기 |
| 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를 실행하세요.
