phase-runner-hud is a Claude Code workflow mod by AyeJK.
For Phase Runner, skills that build a product in phases, raises a toast when a run needs you, and /phase-status prints where the run is with no model call.
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
Version
0.3.0
License
MIT
Repo stars
30
Last change
2026-10-24
What it can reach
Draws in the session
Phase Runner is a set of Claude skills that takes a product from a rough idea to shipped code, in phases and sprints, with you approving at the checkpoints. This mod is optional. Phase Runner works the same without it. The README says the mod never writes to your project: it only reads docs/phases/ and the run logs in docs/phases/.runs/. Start a new session from the project folder that holds docs/phases/. In a folder with no docs/phases/ it stays quiet. One toast fires each time a run stops for you: when a gate fails on its last allowed attempt, when an implementer reports a blocked task, or when the phase completes. The mod checks the newest run log every 2 seconds, and anything that happened before the session started raises nothing. /phase-status prints the phase, each sprint's tasks as done over eligible, the current wave and gate, and when the last event was logged. It starts no turn and uses no tokens. The README says it draws nothing else: versions before 0.3.0 also drew a Phase Runner pane and a live line for the running phase, and both are gone. For the full picture of a run it points to phase-viewer, the dashboard in the same repository. The workspace option defaults to empty, which means the session's directory. Sound defaults to off. In the terminal, Claude Code plays that chime on macOS only. It runs in the terminal and in the desktop app's Code tab. Cursor does not load it. If an update breaks the mod, uninstall it from /plugin. Your phase runs are not affected.
The marketplace, phase-runner, also holds phase-runner, the skills plugin. The slug is this plugin's own name. Telling you when a run needs you is why this page files it under workflow. Since 0.3.0 the toasts are all it draws. The pane of phases this page described before is gone from the plugin. The chime is played by Claude Code, so this page does not list a local program.
Demo
Screenshot of the author's GitHub page.
What it hooks into
session.startWhen a session starts
command.runWhen you run its slash command/phase-status
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/phase-statusPhase Runner: print the running phase, sprint progress, current gate and last event
Files
The author's README and source, 4 files. They load when you open them.