CCG - Claude + Codex + Gemini Multi-Model Collaboration
♥️ 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.
🧩 Also by the author
DSH Marketplace — a directory of DeepSeek Harness plugins. 2,500+ indexed across 14 categories, bilingual EN / 中文.
Not a sponsor — same author as CCG, built out of a plain annoyance: DSH plugins are multiplying fast, but figuring out what one does, whether it still installs, and what the command actually is meant opening one GitHub README after another. So the install commands here are put through a throwaway container first. A plugin only gets a check mark if it really installs — and if it can't, the listing says why (buried in a monorepo subdirectory, never published to npm, and so on). A verified index, not another awesome list.
dsh plugin --profile web add dshmarketplace-plugin # browse the store from inside DSH
npx dshmarketplace-cli add owner/repo # install any plugin from your shell
There is also a Python SDK and a public API. Early days — bug reports and plugin submissions are very welcome on GitHub.
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), Grok (xAI), Kimi Code (Moonshot), and Antigravity through a Go binary bridge.
One command. Describe what you want. The engine handles the rest.
npx ccg-workflow # Install in 60 seconds
Architecture
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, Grok CLI, Kimi Code CLI, and Antigravity 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
Contact
- X (Twitter): @CCG_Workflow
- Email: fengshao1227@gmail.com
- Issues: GitHub Issues
- Community: Linux.do
Star History
License
MIT
v3.4.0 | Issues | Contributing