Files
Claude-Code-Workflow/ccw
catlog22 8b927f302c Fix MCP Manager panel - 13 critical issues resolved
Issues fixed:
1. API endpoint mismatch (/api/mcp-add-global-server)
2. Undefined function reference (installMcpToProject → copyMcpServerToProject)
3. Inline onclick handler scope issues (converted to data-action)
4. querySelector only finding first element (use querySelectorAll)
5. Path normalization causing wrong MCP badge count
6. Lucide icons destroying event listeners (reordered execution)
7. Codex button JSON serialization syntax error
8. Codex API routes 404 (add /api/codex-mcp route matching)
9. False warning suppression for conditional buttons
10. HTML syntax error from JSON in onclick attributes
11. CSS z-index issue - ::before pseudo-element blocking clicks
12. Navigation badge path matching (try both slash formats)
13. Remove deprecated codex_lens tool (merged into smart_search)

Key changes:
- server.ts: Add /api/codex-mcp route matching
- 15-mcp-manager.css: Add pointer-events:none to ::before, z-index for buttons
- components/mcp-manager.js: Fix updateMcpBadge path matching, global exports
- views/mcp-manager.js: Convert onclick to data-action, add event listeners,
  update CCW_MCP_TOOLS list, fix JSON escaping in HTML attributes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-17 19:23:39 +08:00
..

CCW - Claude Code Workflow CLI

A command-line tool for viewing workflow sessions and code review results from the Claude Code Workflow system.

Installation

# Install globally
npm install -g ccw

# Or install from local source
cd path/to/ccw
npm install
npm link

Usage

View Dashboard

# Open workflow dashboard in browser
ccw view

# Specify project path
ccw view -p /path/to/project

# Generate dashboard without opening browser
ccw view --no-browser

# Custom output path
ccw view -o report.html

Features

Workflow Dashboard

  • Active Sessions: View all active workflow sessions with task progress
  • Archived Sessions: Browse completed/archived sessions
  • Task Tracking: See individual task status (pending/in_progress/completed)
  • Progress Bars: Visual progress indicators for each session

Review Integration

  • Code Review Findings: View results from review-module-cycle
  • Severity Distribution: Critical/High/Medium/Low finding counts
  • Dimension Analysis: Findings by review dimension (Security, Architecture, Quality, etc.)
  • Tabbed Interface: Switch between Workflow and Reviews tabs

Dashboard Data Sources

The CLI reads data from the .workflow/ directory structure:

.workflow/
├── active/
│   └── WFS-{session-id}/
│       ├── workflow-session.json    # Session metadata
│       ├── .task/
│       │   └── IMPL-*.json          # Task definitions
│       └── .review/
│           ├── review-progress.json # Review progress
│           └── dimensions/
│               └── *.json           # Dimension findings
└── archives/
    └── WFS-{session-id}/            # Archived sessions

Bundled Templates

The CLI includes bundled dashboard templates:

  • workflow-dashboard.html - Workflow session and task visualization
  • review-cycle-dashboard.html - Code review findings display

No external template installation required - templates are included in the npm package.

Requirements

  • Node.js >= 16.0.0
  • npm or yarn

Integration with Claude Code Workflow

This CLI is a standalone tool that works with the Claude Code Workflow system:

  1. Install CCW CLI (via npm)

    • npm install -g ccw
    • Provides ccw view command for dashboard viewing
    • Templates are bundled - no additional installation required
  2. Optional: Install Claude Code Workflow (via Install-Claude.ps1)

    • Provides workflow commands, agents, and automation
    • CCW will automatically detect and display workflow sessions

Options

Option Description
-p, --path <path> Path to project directory (default: current directory)
--no-browser Generate dashboard without opening browser
-o, --output <file> Custom output path for HTML file
-V, --version Display version number
-h, --help Display help information

Development

# Clone and install dependencies
git clone <repo-url>
cd ccw
npm install

# Link for local testing
npm link

# Test the CLI
ccw view -p /path/to/test/project

License

MIT