hoangbits/claude-implement-plan-tracker
hoangbits@hoangbits
이 mod 소개
전체 계획을 항상 패널에 표시하는 Claude Code 플러그인입니다.
2/5 done · ~45 min left · task list
✓ 1. Read ticket (~5 min)
✓ 2. Write OpenSpec proposal (~15 min)
▶ 3. Implement context functions (~20 min)
○ 4. Add tests (~10 min)
○ 5. Commit and open PR (~5 min)
> Add a step after the current one
- 각 단계에
✓완료,▶현재,○대기 표시 done/total개수와 남은 시간- Claude가 작업 중일 때도 단계를 추가할 수 있는 텍스트 상자
- 상태 줄 항목:
Plan 2/5 · ~45 min left ▶ Implement context functions
남은 시간
플러그인은 Claude에게 각 단계 끝에 (~10 min) 같은 예상 시간을 적도록 요청합니다.
- 어떤 단계도 완료되지 않았을 때 남은 시간은 Claude의 예상 시간 합계입니다.
- 단계가 끝나면 실제 소요 시간을 측정하고, 실제 시간/예상 시간으로 Claude의 예상을 조정합니다.
- 예상 시간이 없는 단계는 측정된 시간의 평균을 사용합니다.
- 현재 단계의 경과 시간은 차감합니다.
Claude 작업 중 단계 추가
ctrl+x tab을 눌러 패널에 포커스를 두고, Tab으로 텍스트 상자에 이동한 다음 단계를 입력하고 Enter를 누릅니다. 단계는 현재 단계 뒤에 들어갑니다.
- Task list: 플러그인이 작업 목록을 다시 쓰거나 작업을 만들어 새 단계를 추가합니다.
- OpenSpec: 현재 단계 뒤에
- [ ]줄을tasks.md에 씁니다. - Claude는 다음 도구 호출의 결과와 함께 새 단계에 대한 메모를 받으므로 멈추지 않고 편집 내용을 확인합니다. Claude가 대기 중이면 다음 메시지와 함께 메모가 전달됩니다.
계획 출처
- 주 대화의 Claude Code 작업 목록(
TodoWrite또는TaskCreate/TaskUpdate/TaskList). - 작업 목록이 없을 때는 최신
openspec/changes/<change>/tasks.md의 체크박스(archive폴더는 제외)입니다. 파일이 바뀔 때와 각 턴이 끝날 때 패널이 새로 고쳐집니다.
설치
/plugin marketplace add hoangbits/claude-implement-plan-tracker
/plugin install implement-plan-tracker@implement-plan-tracker
이 플러그인은 Claude Code function hook(얼리 액세스)을 사용합니다. 플러그인 function hook을 지원하는 Claude Code 빌드가 필요합니다.
사용
- 패널은 세션 시작 시 열립니다. 144열보다 좁은 터미널에서는 패널을 열 때까지 기다립니다.
- 언제든
/plan을 입력해 패널을 엽니다. ctrl+x tab으로 패널에 포커스를 옮기고Esc또는ctrl+x x로 닫습니다.
개발
claude plugin validate .
claude plugin test .
claude --plugin-dir .
설치
먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.
claude plugin marketplace add hoangbits/claude-implement-plan-tracker claude plugin install implement-plan-tracker
원문 / README
claude-implement-plan-tracker
A Claude Code plugin that always shows the whole plan in a pane:
2/5 done · ~45 min left · task list
✓ 1. Read ticket (~5 min)
✓ 2. Write OpenSpec proposal (~15 min)
▶ 3. Implement context functions (~20 min)
○ 4. Add tests (~10 min)
○ 5. Commit and open PR (~5 min)
> Add a step after the current one
- Every step, with
✓done,▶current,○pending - A
done/totalcount and the time left - A text box to add a step, also while Claude is working
- A status line entry:
Plan 2/5 · ~45 min left ▶ Implement context functions
Time left
The plugin asks Claude to end each step with an estimate, for example (~10 min).
- Before any step is done, the time left is the sum of Claude's estimates.
- After steps are done, the plugin measures how long each one took. It scales Claude's estimates by actual time / estimated time.
- Steps without an estimate use the average measured time.
- The current step's elapsed time is subtracted.
Add a step while Claude works
Press ctrl+x tab to focus the pane, Tab to the text box, type the step, and press Enter. The step goes after the current step.
- Task list: the plugin rewrites the task list (or creates a task) with the new step.
- OpenSpec: the plugin writes a
- [ ]line intotasks.mdafter the current step. - Claude gets a note about the new step with the result of its next tool call, so it sees the edit without stopping. If Claude is idle, the note goes with your next message.
Plan source
- Claude Code's task list (
TodoWrite, orTaskCreate/TaskUpdate/TaskList) for the main conversation. - When there is no task list: the checkboxes in the newest
openspec/changes/<change>/tasks.md(thearchivefolder is skipped). The pane refreshes when that file changes and at the end of each turn.
Install
/plugin marketplace add hoangbits/claude-implement-plan-tracker
/plugin install implement-plan-tracker@implement-plan-tracker
The plugin uses Claude Code function hooks (early access). It needs a Claude Code build with plugin function hooks.
Use
- The pane opens at session start. In a terminal narrower than 144 columns, it waits until you open it.
- Type
/planto open the pane at any time. ctrl+x tabmoves focus to the pane.Escorctrl+x xcloses it.
Develop
claude plugin validate .
claude plugin test .
claude --plugin-dir .
