✨ Update Claude plugin to v0.3.0 with full CLI support

[Robdel12]

Summary

• Remove MCP references - the plugin is now purely skills-based using the Vizzly CLI
• Update all CLI commands to match the current Vizzly CLI structure (v0.27.0)
• Add review commands: vizzly approve, vizzly reject, vizzly comment
• Add cloud build commands: vizzly status, vizzly builds, vizzly comparisons
• Add account commands: vizzly login, vizzly logout, vizzly whoami, vizzly orgs, vizzly projects
• Add project commands: vizzly project:select, vizzly project:list, vizzly project:token, vizzly project:remove
• Update setup instructions to use the vizzly project:select workflow instead of deprecated commands
• Add "CLI Integration" section to README showing key CLI commands

Test plan

• Install plugin locally: claude --plugin-dir ./vizzly-plugin/plugins/vizzly
• Verify skills activate when asking about visual tests
• Verify CLI commands in knowledge match vizzly --help output

[claude]

PR Review: ✨ Update Claude plugin to v0.3.0 with full CLI support

Overall Assessment

This is a well-structured update that significantly improves the Claude plugin by documenting all available CLI commands. The changes align well with the current CLI codebase (v0.27.0) and provide comprehensive coverage of new functionality.

✅ Strengths

1. Accurate CLI Command Documentation

All commands documented in the plugin match the actual CLI implementation:

• Review commands (approve, reject, comment) match src/commands/review.js
• Project commands (project:select, project:list, project:token, project:remove) match src/commands/project.js
• Cloud commands (status, builds, comparisons) match existing command files

2. Improved Authentication Flow

The setup instructions correctly reflect the modern workflow:

• Changed from deprecated vizzly project link to vizzly project:select
• Proper guidance for vizzly login followed by project selection
• Clear distinction between local TDD (no token needed) and cloud mode (requires auth)

3. Comprehensive Coverage

The vizzly-knowledge/SKILL.md now includes:

• 40+ CLI commands across all categories
• Clear categorization (TDD, Cloud, Review, Account, Project, Advanced)
• Accurate command syntax and descriptions

4. Consistent Messaging

• Version bumped consistently: 0.2.0 → 0.3.0 in both marketplace.json and plugin.json
• Description updated to include "review changes" capability
• READMEs updated with new CLI integration section

🔍 Issues & Suggestions

1. Command Syntax Inconsistency (Minor)

In vizzly-knowledge/SKILL.md:95-97, the documentation shows:

vizzly approve <comparison-id>
vizzly reject <comparison-id>
vizzly comment <build-id> "msg"

However, the actual CLI requires:

• vizzly reject requires --reason flag (line 870 in cli.js)
• vizzly comment requires message as an argument, not a string

Suggested fix:

vizzly approve <comparison-id>  # Approve a comparison
vizzly reject <comparison-id> --reason "explanation"  # Reject with reason (required)
vizzly comment <build-id> "message"  # Add comment to build

2. Missing Command Context (Enhancement)

The check-visual-tests/SKILL.md adds cloud commands (lines 141-148) but doesn't explain when to use local vs. cloud commands. Consider adding a brief note:

**For local TDD:**
vizzly tdd status         # Show current test status
vizzly baselines          # List and query baselines

**For cloud builds:**
vizzly status <build-id>  # Check specific build status (requires build ID from CI)
vizzly builds             # List recent builds
vizzly comparisons        # Query and search comparisons

3. Incomplete Command Examples (Minor)

In debug-visual-regression/SKILL.md:137-139, the cloud approve example shows:

Cloud build: vizzly approve <comparison-id>

Consider showing how users find the comparison ID:

Cloud build: 
  1. Find comparison: vizzly comparisons --filter="homepage"
  2. Approve it: vizzly approve <comparison-id>

4. Test Plan Incomplete (Process)

The PR test plan has unchecked items. Before merging, please verify:

• Install plugin locally and test skill activation
• Verify CLI commands match vizzly --help output
• Test that Claude can successfully execute review commands when invoked

🔒 Security Considerations

No security concerns. The plugin only documents CLI commands without adding new execution paths or handling sensitive data differently.

🎯 Test Coverage

No test changes needed - this is purely documentation. However, consider adding integration tests in the future to verify plugin documentation stays in sync with CLI commands.

📝 Suggestions for Future PRs

1. Version Alignment: Consider adding a check in CI to ensure plugin version references match actual CLI version in package.json
2. Command Discovery: Could auto-generate parts of SKILL.md from vizzly --help output to prevent drift
3. Examples Directory: Add a examples/ folder showing complete workflows (local TDD → cloud review)

✨ Recommendation

Approve with minor fixes

This PR significantly improves the Claude plugin's usefulness by documenting the full CLI surface area. The only required changes are fixing the command syntax inconsistencies (#1 above). The other suggestions are enhancements that can be addressed in follow-up PRs.

Great work modernizing the authentication flow and removing MCP complexity!

---

Files to update before merge:

• vizzly-plugin/plugins/vizzly/skills/vizzly-knowledge/SKILL.md (lines 95-97: add --reason flag)
• Complete test plan checklist items

[vizzly-testing]

Vizzly - Visual Test Results

CLI Reporter - 8 changes need review

Status	Count
Passed	10
Changed	8
Auto-approved	10

Changes needing review (8)

fullscreen-viewer · Firefox · 1920×1080 · 0.1% diff

bulk-accept-dialog · Firefox · 1920×1080 · 0.5% diff

viewer-slide-mode · Firefox · 1920×1080 · 0.5% diff

filter-failed-only · Firefox · 375×704 · 14.7% diff

viewer-zoomed-100 · Firefox · 1920×1080 · 0.4% diff

fullscreen-viewer · Firefox · 375×667 · 188.3% diff

...and 2 more in Vizzly.

Review changes

CLI TUI - Approved

5 comparisons, no changes detected.

View build

---

_{update-claude-plugin-v0.3.0 · 2d724e0b}