/plan-canvas

Plan Canvas Command

Opens a local artifact in the Plan Canvas — ECC's browser review surface — where the user annotates elements, chats with you, and approves the plan or requests changes without leaving the page.

This command is a thin entry point over the plan-canvas skill. Follow that skill for the full workflow and rules.

What This Command Does

1. Resolve the artifact: the given path, else the most recently modified .claude/plans/*.plan.md, else ask what to review.
2. ecc-plan-canvas open <artifact> — opens the user's browser.
3. ecc-plan-canvas await <artifact> — block until feedback, verdict, or session end; leave it running.
4. Apply feedback to the artifact file (the canvas live-reloads), answer with await <artifact> --reply "...", and repeat until the user approves or ends the session.

An approve verdict counts as plan confirmation for /plan-style gates: stop polling, end the session, and begin implementation.

Example

User: /plan-canvas .claude/plans/notifications.plan.md

Assistant: (runs open + await, browser opens)
...user clicks "Request changes" with two annotations...
Assistant: (edits the plan, replies in-canvas, awaits again)
...user clicks "Approve plan"...
Assistant: Plan approved in the canvas — starting implementation.

Related

• plan-canvas skill — full workflow, feedback JSON shapes, rules
• /plan — produces the plan artifacts this reviews
• Source: scripts/plan-canvas.js, scripts/lib/plan-canvas/