mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
d941166d84
Problem: When generating hook configurations, the convertToClaudeCodeFormat function was using double quotes to wrap bash -c script arguments. This caused complex escaping issues with jq commands inside, leading to parse errors like "jq: error: syntax error, unexpected end of file". Solution: For bash -c commands, now use single quotes to wrap the script argument. Single quotes prevent shell expansion, so internal double quotes (like those used in jq patterns) work naturally without excessive escaping. If the script contains single quotes, they are properly escaped using the '\'' pattern (close quote, escaped quote, reopen quote). Fixes: https://github.com/catlog22/Claude-Code-Workflow/issues/73 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
CCW - Claude Code Workflow CLI
A powerful command-line tool for managing Claude Code Workflow with native CodexLens code intelligence, multi-model CLI orchestration, and interactive dashboard.
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
🔍 Native CodexLens (v6.3)
- Full-Text Search (FTS): SQLite-based fast keyword search with symbol extraction
- Semantic Search: Dense embedding-based similarity search with vector store
- Hybrid Search: RRF (Reciprocal Rank Fusion) combining FTS and semantic results
- Cross-Encoder Reranking: Second-stage reranker for improved result relevance
- HNSW Index: Approximate Nearest Neighbor index for significantly faster vector search
- Dynamic Batch Processing: Intelligent batch size calculation for embedding generation
- Workspace Index Status: Real-time index status monitoring and management
💻 CLI Tools Integration
- Multi-Model Support: Execute prompts with Gemini, Qwen, Codex, Claude, or OpenCode
- CLI Wrapper Endpoints: Custom API endpoints with tool calling support
- Smart Content Formatter: Intelligent output formatting with structured IR
- Session Resume: Resume from last session or merge multiple sessions
- SQLite History: Persistent execution history with conversation tracking
- Custom IDs: Support for custom execution IDs and multi-turn conversations
- Preload Service: Optimized data fetching with caching for faster responses
🧠 Core Memory & Clustering
- Session Clustering: Intelligent grouping of related sessions
- Cluster Visualization: Interactive display with Cytoscape.js
- Cluster Management: Delete, merge, and deduplicate operations
🖥️ Dashboard Views
- Workflow Dashboard: Active/archived sessions with task progress
- CodexLens Manager: Index management with real-time progress bar
- Core Memory: Session clustering visualization
- CLAUDE.md Manager: File tree viewer for configuration
- Skills Manager: View and manage Claude Code skills
- Graph Explorer: Interactive code relationship visualization
- MCP Manager: Configure and monitor MCP servers
- Hook Manager: Manage Claude Code hooks
- Help View: Internationalized help documentation
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 visualizationreview-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:
-
Install CCW CLI (via npm)
npm install -g ccw- Provides
ccw viewcommand for dashboard viewing - Templates are bundled - no additional installation required
-
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