CCG - Claude + Codex + Gemini Multi-Model Collaboration

<div align="center"> <img src="assets/logo/ccg-logo-cropped.png" alt="CCG Workflow" width="400">

简体中文 | English | Documentation

</div>

♥️ Sponsor

Gamma Remover — Free browser-local Gamma watermark remover for PDF & PPTX. No signup, instant results, 100% private. Your files never leave your device.

---

302.AI is a pay-as-you-go enterprise AI resource hub that offers the latest and most comprehensive AI models and APIs on the market, along with a variety of ready-to-use online AI applications.

---

What is CCG?

CCG is a workflow engine for Claude Code. It turns Claude into a multi-model orchestrator — Claude stays in control while dispatching specialized work to Codex (OpenAI), Gemini (Google), and Grok (xAI) through a Go binary bridge.

One command. Describe what you want. The engine handles the rest.

npx ccg-workflow    # Install in 60 seconds

Architecture

<div align="center"> <img src="assets/readme/architecture.png" alt="CCG Architecture" width="800"> </div>

Claude Code is the lead orchestrator. It analyzes your intent, selects a strategy, and manages the entire workflow. The Hook Engine injects state every turn so Claude never loses context — even after compaction. The codeagent-wrapper (a compiled Go binary) bridges Claude to external models for parallel analysis and review.

How It Works

You: /ccg:go add JWT authentication to this API

CCG Engine:
  1. Reads project context (git status, tech stack, file structure)
  2. Classifies: feature / L complexity / backend / high risk
  3. Selects strategy: full-collaborate
  4. Creates .ccg/tasks/add-jwt-auth/task.json
  5. Launches dual-model analysis (Codex + Gemini in parallel)
  6. Produces plan → HARD STOP for your approval
  7. Spawns Agent Teams Builders for parallel implementation
  8. Runs quality gates + dual-model cross-review
  9. Reports results

Every turn, a hook injects:
  <ccg-state>
  Task: add-jwt-auth (in_progress)
  Strategy: full-collaborate
  Phase: 4-implementation
  </ccg-state>

10 Built-in Strategies

The engine auto-selects the right strategy based on task type and complexity:

| Strategy | When | External Models | Agent Teams | |----------|------|:---:|:---:| | direct-fix | Simple bug, single file | — | — | | quick-implement | Small feature, clear scope | — | — | | guided-develop | Medium feature, needs planning | Single | — | | full-collaborate | Complex feature, multi-module | Dual parallel | ✓ | | debug-investigate | Complex bug, unknown cause | Dual diagnosis | — | | refactor-safely | Code restructuring | Dual review | — | | deep-research | Technical research | Dual exploration | — | | optimize-measure | Performance optimization | Optional | — | | review-audit | Code review | Dual cross-review | — | | git-action | commit, rollback, branches | — | — |

Simple tasks run fast with zero overhead. Complex tasks get the full engine.

Core Features

Hook Engine — Never Lose Context

4 JavaScript hooks inject state into every Claude Code session:

| Hook | Event | What it does | |------|-------|-------------| | workflow-state.js | Every turn | Injects current task state as breadcrumb | | session-start.js | Session start/compact | Re-injects full project context | | subagent-context.js | Agent/Bash spawn | Injects spec directly into subagent prompts | | skill-router.js | Every turn | Auto-injects domain knowledge by keyword |

Context survives compaction. Sub-agents born with spec in their prompt. Zero state loss.

Task System — Persistent Lifecycle

Medium+ complexity tasks get a persistent directory:

.ccg/tasks/add-jwt-auth/
├── task.json         # Status, strategy, phase, gate
├── requirements.md   # Enhanced requirements
├── plan.md           # Approved implementation plan
├── context.jsonl     # Spec files for sub-agent injection
├── review.md         # Review results
└── research/         # Persisted research findings

Quality Gates — Built-in Security & Quality

| Gate | Trigger | |------|---------| | /ccg:verify-security | New modules, security changes | | /ccg:verify-quality | Changes > 30 lines | | /ccg:verify-change | Doc sync check | | /ccg:verify-module | Module structure check | | /ccg:gen-docs | Auto-generate README + DESIGN |

100+ Domain Knowledge Files

When your message mentions security, caching, RAG, Kubernetes, etc., the relevant knowledge file is auto-injected. 10 domains, 61 files:

Security · Architecture · DevOps · AI/MLOps · Development · Frontend Design · Infrastructure · Mobile · Data Engineering · Orchestration

Commands

Core (v3.0 default: 13 commands)

| Command | Description | |---------|-------------| | /ccg:go | Smart entry — describe what you want, engine handles the rest | | /ccg:commit | Smart conventional commit | | /ccg:rollback | Interactive rollback | | /ccg:clean-branches | Clean merged branches | | /ccg:worktree | Worktree management | | /ccg:init | Initialize project CLAUDE.md | | /ccg:context | Project context management |

OpenSpec Integration

| Command | Description | |---------|-------------| | /ccg:spec-init | Initialize OPSX environment | | /ccg:spec-research | Requirements → constraints | | /ccg:spec-plan | Constraints → zero-decision plan | | /ccg:spec-impl | Execute plan + archive | | /ccg:spec-review | Dual-model cross-review |

Legacy Mode (18 additional commands)

Includes /ccg:workflow, /ccg:plan, /ccg:execute, /ccg:frontend, /ccg:backend, /ccg:analyze, /ccg:debug, /ccg:optimize, /ccg:test, /ccg:review, /ccg:team, and more.

Quick Start

# Install (interactive 4-step wizard)
npx ccg-workflow

# Or non-interactive with defaults
npx ccg-workflow init --skip-prompt

Requires Node.js 20+ and Claude Code CLI. Codex CLI, Gemini CLI, and Grok CLI are optional (enable multi-model features).

CLI Commands

npx ccg-workflow                          # Interactive menu
npx ccg-workflow init                     # 4-step install wizard
npx ccg-workflow doctor                   # Environment health check
npx ccg-workflow status                   # Installation overview
npx ccg-workflow codex-mode install       # Install Codex-Led mode
npx ccg-workflow codex-mode uninstall     # Uninstall Codex-Led mode
npx ccg-workflow uninstall                # Uninstall CCG
npx ccg-workflow config mcp               # Configure MCP tokens
npx ccg-workflow diagnose-mcp             # Diagnose MCP issues

Configuration

~/.claude/
├── commands/ccg/          # Slash commands
├── hooks/ccg/             # Hook scripts (5 files)
├── skills/ccg/            # Quality gates + 100+ domain knowledge
├── rules/                 # Auto-trigger rules
├── .ccg/
│   ├── config.toml        # Model routing, MCP, performance
│   ├── engine/            # 10 strategy files + model router
│   └── prompts/           # Expert prompts (codex/gemini/claude)
└── bin/codeagent-wrapper  # Multi-model bridge (Go binary)

Environment Variables

Set in ~/.claude/settings.json under "env":

| Variable | Default | Description | |----------|---------|-------------| | CODEX_TIMEOUT | 7200 | Wrapper timeout (seconds) | | CODEAGENT_POST_MESSAGE_DELAY | 5 | Post-completion delay | | CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS | unset | Set 1 for parallel Agent Teams |

Update / Uninstall

npx ccg-workflow@latest     # Update to latest
npx ccg-workflow doctor     # Check health after update
npx ccg-workflow uninstall  # Clean uninstall

Credits

• cexll/myclaude — codeagent-wrapper inspiration
• UfoMiao/zcf — Git tools reference
• mindfold-ai/Trellis — Hook-based workflow state patterns
• ace-tool — MCP code retrieval

Contributors

<!-- readme: contributors -start --> <table> <tr> <td align="center"><a href="https://github.com/fengshao1227"><img src="https://avatars.githubusercontent.com/fengshao1227?v=4&s=100" width="100;" alt="fengshao1227"/><br />_{<b>fengshao1227</b>}</a></td> <td align="center"><a href="https://github.com/SXP-Simon"><img src="https://avatars.githubusercontent.com/SXP-Simon?v=4&s=100" width="100;" alt="SXP-Simon"/><br />_{<b>SXP-Simon</b>}</a></td> <td align="center"><a href="https://github.com/RebornQ"><img src="https://avatars.githubusercontent.com/RebornQ?v=4&s=100" width="100;" alt="RebornQ"/><br />_{<b>RebornQ</b>}</a></td> <td align="center"><a href="https://github.com/Sakuranda"><img src="https://avatars.githubusercontent.com/Sakuranda?v=4&s=100" width="100;" alt="Sakuranda"/><br />_{<b>Sakuranda</b>}</a></td> <td align="center"><a href="https://github.com/Mriris"><img src="https://avatars.githubusercontent.com/Mriris?v=4&s=100" width="100;" alt="Mriris"/><br />_{<b>Mriris</b>}</a></td> <td align="center"><a href="https://github.com/23q3"><img src="https://avatars.githubusercontent.com/23q3?v=4&s=100" width="100;" alt="23q3"/><br />_<b>23q3</b></a></td> <td align="center"><a href="https://github.com/MrNine-666"><img src="https://avatars.githubusercontent.com/MrNine-666?v=4&s=100" width="100;" alt="MrNine-666"/><br />_{<b>MrNine-666</b>}</a></td> </tr> <tr> <td align="center"><a href="https://github.com/GGzili"><img src="https://avatars.githubusercontent.com/GGzili?v=4&s=100" width="100;" alt="GGzili"/><br />_{<b>GGzili</b>}</a></td> </tr> </table> <!-- readme: contributors -end -->

Contact

• X (Twitter): [@CCG_Workflow](https://x.com