dashboard

STOP — DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Begin executing immediately.

Step 0 — Immediate Output

Before ANY tool calls, display this banner:

╔══════════════════════════════════════════════════════════════╗
║  PLAN-BUILD-RUN ► DASHBOARD                                  ║
╚══════════════════════════════════════════════════════════════╝

Then proceed to Step 1.

Behavior

1. Parse arguments: Extract --port N from the user's input. Default to 3141.

1. Locate dashboard: The dashboard lives at the repository root dashboard/ directory (NOT under ${CLAUDE_PLUGIN_ROOT}). Resolve the repo root from <cwd> — for PBR's own repo this is the project root; for installed plugins, use git rev-parse --show-toplevel or walk up from ${CLAUDE_PLUGIN_ROOT} to find dashboard/.

1. Check dependencies: Check if <repo-root>/dashboard/server/node_modules/ exists. If not, run:

``bash npm run dashboard:install --prefix <repo-root> ``

1. Launch dashboard: Run in background via Bash:

``bash node <repo-root>/dashboard/bin/cli.cjs --dir <cwd> --port <port> & ``

Use & to background the process so it doesn't block the session.

1. Verify startup: After launching, check the process is responding:

``bash curl -s -o /dev/null -w "%{http_code}" http://localhost:<port>/ ``

1. Output to user:

``text Dashboard running at http://localhost:<port> Open this URL in your browser to view your project's planning state. ``

Notes

• If the port is already in use, the dashboard will fail to start — suggest the user try a different port with --port.
• The dashboard watches .planning/ for live updates via WebSockets.