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
残り時間
プラグインは各手順の最後に (~10 min) のような見積もりを Claude に付けさせます。
- どの手順も完了していない間は、残り時間は 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 .
