English | 中文

✨ Key Features

🎯 4-Level Workflows

From lite-lite-lite (instant) to brainstorm (multi-role analysis)

🔄 Multi-CLI Orchestration

Gemini, Qwen, Codex, Claude - auto-select or manual

⚡ Dependency-Aware Parallelism

Agent parallel execution without worktree complexity

🔧 Issue Workflow

Post-development maintenance with optional worktree isolation

📦 JSON-First State

.task/IMPL-*.json as single source of truth

🖥️ Dashboard

Visual session management, CodexLens search, graph explorer

📖 New? See Workflow Guide for the complete 4-level workflow system.

🚀 Quick Start

Install CCW

npm install -g claude-code-workflow
ccw install -m Global

Choose Your Workflow Level

Workflow Examples

# Level 1: Instant execution
/workflow:lite-lite-lite "Fix typo in README"

# Level 2: Lightweight planning
/workflow:lite-plan "Add JWT authentication"
/workflow:lite-fix "User upload fails with 413 error"

# Level 3: Standard planning with session
/workflow:plan "Implement payment gateway integration"
/workflow:execute

# Level 4: Multi-role brainstorming
/workflow:brainstorm:auto-parallel "Design real-time collaboration system" --count 5
/workflow:plan --session WFS-xxx
/workflow:execute

🛠️ CLI Tool Installation

🎭 Semantic CLI Invocation

Users can semantically specify CLI tools in prompts - the system automatically invokes the corresponding CLI.

Basic Invocation

| User Prompt | System Action | |-------------|---------------| | "Use Gemini to analyze the auth module" | Auto-invoke gemini CLI for analysis | | "Let Codex review this code" | Auto-invoke codex CLI for review | | "Ask Qwen about performance optimization" | Auto-invoke qwen CLI for consultation |

Multi-CLI Orchestration

| Pattern | User Prompt Example | |---------|---------------------| | Collaborative | "Use Gemini and Codex to collaboratively analyze security vulnerabilities" | | Parallel | "Have Gemini, Codex, and Qwen analyze the architecture in parallel" | | Iterative | "Use Gemini to diagnose, then Codex to fix, iterate until resolved" | | Pipeline | "Gemini designs the solution, Codex implements, Claude reviews" |

# Single CLI invocation
User: "Use Gemini to analyze the database query performance"
→ System auto-calls: gemini CLI with analysis task

# Collaborative analysis
User: "Use Gemini and Codex to collaboratively review the authentication flow"
→ System auto-calls: gemini + codex CLIs, synthesizes results

# Parallel multi-perspective
User: "Have all available CLIs analyze this architecture design in parallel"
→ System auto-calls: gemini, codex, qwen in parallel → merged report

# Sequential pipeline
User: "Use Gemini to plan the refactoring, then Codex to implement it"
→ System auto-calls: gemini (plan) → codex (implement) sequentially

Custom CLI Registration

Register any API as a custom CLI via Dashboard interface:

ccw view  # Open Dashboard → Status → API Settings → Add Custom CLI

| Field | Example | |-------|---------| | Name | deepseek | | Endpoint | https://api.deepseek.com/v1/chat | | API Key | your-api-key |

⚙️ Register once, invoke semantically forever - no code changes needed.

🔍 ACE Tool Configuration

ACE (Augment Context Engine) provides powerful semantic code search.

| Method | Link | |--------|------| | Official | Augment MCP Documentation | | Proxy | ace-tool (GitHub) |

📚 CodexLens Local Search

⚠️ In Development: CodexLens is under iterative optimization. Some features may be unstable.

# Enter codex-lens directory
cd codex-lens

# Install dependencies
pip install -e .

# Initialize index
codexlens index /path/to/project

Open Dashboard via ccw view, manage indexes and execute searches in CodexLens Manager.

💻 CCW CLI Commands

🌟 Recommended Commands (Main Features)

Quick Examples:

# /ccw - Auto workflow selection (Main Process)
/ccw "Add user authentication"              # Auto-selects workflow based on intent
/ccw "Fix memory leak in WebSocket"         # Detects bugfix workflow
/ccw "Implement with TDD"                   # Routes to TDD workflow

# /ccw-coordinator - Manual chain orchestration (External CLI)
/ccw-coordinator "Implement OAuth2 system"  # Analyzes → Recommends chain → User confirms → Executes

Key Differences:

| Aspect | /ccw | /ccw-coordinator | |--------|------|------------------| | Execution | Main process (SlashCommand) | External CLI (background tasks) | | Selection | Auto intent-based | Smart recommendation + optional adjustment | | State | TodoWrite tracking | Persistent state.json | | Use Case | General tasks, quick dev | Complex chains, resumable |

Other CLI Commands

ccw install           # Install workflow files
ccw view              # Open dashboard
ccw cli -p "..."      # Execute CLI tools (Gemini/Qwen/Codex)
ccw upgrade -a        # Upgrade all installations

Dashboard Features

📖 Documentation

| Document | Description | |----------|-------------| | Workflow Guide | 4-level workflow system (recommended) | | Getting Started | 5-minute quick start | | Dashboard Guide | Dashboard user guide | | FAQ | Common questions | | Changelog | Version history |

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                     Main Workflow (4 Levels)                    │
│  ⚡ Level 1: lite-lite-lite (instant, no artifacts)             │
│  📝 Level 2: lite-plan / lite-fix / multi-cli-plan (→ execute)  │
│  📊 Level 3: plan / tdd-plan / test-fix-gen (session persist)   │
│  🧠 Level 4: brainstorm:auto-parallel → plan → execute          │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│                   Issue Workflow (Supplement)                   │
│  🔍 discover → 📋 plan → 📦 queue → ▶️ execute (worktree)        │
└─────────────────────────────────────────────────────────────────┘

Core Principles:

• ⚡ Dependency Analysis solves parallelism - no worktree needed for main workflow
• 🔧 Issue Workflow supplements main workflow for post-development maintenance
• 🎯 Select workflow level based on complexity - avoid over-engineering

🤝 Contributing

📄 License

MIT License - see LICENSE