ClaudeCodeMod

All shelves / Mods / Workflow

phase-runner-hud

By AyeJK

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.

Draws

Install

The marketplace name is phase-runner.

In Claude Code
/plugin install phase-runner-hud --marketplace AyeJK/phase-runner
Open the repo

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

The top of the phase-runner-hud README on the author's GitHub page: it raises a toast when a run needs you and draws nothing else, then the three toasts, for an escalation, a blocker, and a completed phase
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.

Facts

Author
AyeJK
Category
Workflow
Marketplace
phase-runner
Repo
AyeJK/phase-runner
Folder
hud
Version
0.3.0
License
MIT
Repo stars
30
Last change
2026-10-24
Language
TypeScript
Files
28

Other mods in Workflow

followthrough-bandbayramannakovFor Followthrough, a ledger of checks that outlive the session, draws the checks due for this repo above the prompt.jaira-cockpitBeMuCaFor Jaira, a markdown kanban for agent work, draws the tickets waiting on you, and waits before a large prompt goes out on a cold cache.showrunner-modBendzaeFor Showrunner, a terminal manager for agent sessions, draws the task above the prompt and reports that session's status back.command-centerBioInfoFor Claudelicious, one operator's Claude Code cookbook, draws a pane of the session's intent, running jobs, and open questions.todo-barhoobnnDraws a progress bar of Claude's task list above the prompt: the task in progress, how long it has run, and what is next.ts-bandhoobnnDraws your Tailscale machines above the prompt: one mark while every node is online and direct, otherwise the relayed or offline ones.agent-watchice-lfernandesDraws each subagent's tokens and a stall toast, and the last tool calls, with a summary of the heaviest agent when they finish.launchpadice-lfernandesDraws a menu of installed commands, skills, and agents under the header, above the prompt, or in a pane, and a panel that sets the model and effort.plain-viewice-lfernandesHides successful tool rows and draws the agent's plan as a card above the prompt, with the current step and a summary when the turn ends.ide-modjkf87Opens an IDE window in the session, with an agent board, a file tree, and tabbed documents, and draws a usage gauge above the prompt.agent-discoverkeshrathOpens a pane to search, approve, and enable MCP servers through agent-discover, a local daemon any MCP host can share.flowctlMarcoFilho1Draws Claude Code's plan as a live graph in FlowCTL, a floating window: what is running, what comes next, and when a step needs you.
All 396 in Workflow