Live updates — watches ~/.claude/plans/ and re-renders when plans change
Auto-opens when Claude Code creates or updates a plan file
Context menu — right-click any .md file to open in the viewer
Keyboard shortcut — Cmd+Shift+G (Mac) / Ctrl+Shift+G (Windows/Linux) to render the active markdown file
Usage
Automatic
When Claude Code writes a plan file, the viewer panel opens automatically in a side column.
Manual
Command Palette: Claude Plans: Open Plan Viewer — pick from your plans
Right-click: any .md file in Explorer or editor → "Open in Plan Viewer"
Keyboard: Cmd+Shift+G / Ctrl+Shift+G while editing a .md file
Editor title bar: click the "Open in Plan Viewer" button
Task Status Detection
The viewer parses ### headings for task status emoji markers:
Marker
Status
Color
✅
Done
Green
🔄
In Progress
Amber
⏸️
Deferred
Gray
(none)
Todo
Blue
Claude Code Integration
On first activation, the extension installs a PostToolUse hook in ~/.claude/settings.json that triggers the viewer whenever Claude writes to a plan file.
