CC-MIRROR
Claude Code, Unshackled
Pre-configured Claude Code variants with custom providers,
prompt packs, and battle-tested enhancements.
One command. Instant power-up.
Note: Team mode is only supported in the published cc-mirror 1.6.3 release.
Current development builds do not patch Claude Code; the focus is provider enablement and stable updates.
Legacy Team Mode (cc-mirror 1.6.3)
Claude Code has a hidden multi-agent capability. CC-MIRROR enabled it in the 1.6.3 release.
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ BEFORE AFTER │
│ ══════ ═════ │
│ │
│ ┌─────────────────┐ ┌─────────────────────────────────┐ │
│ │ Claude Code │ │ YOUR Claude Code │ │
│ │ │ CC-MIRROR │ │ │
│ │ • Single │ ─────────► │ ✓ Multi-Agent Orchestration │ │
│ │ config │ │ ✓ Task-based Coordination │ │
│ │ • No team │ │ ✓ Background Agent Spawning │ │
│ │ mode │ │ ✓ Battle-tested Skill │ │
│ │ │ │ ✓ Isolated Config │ │
│ └─────────────────┘ └─────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
What gets unlocked:
| Tool | Purpose |
|---|---|
TaskCreate |
Create tasks with subject, description, and dependencies |
TaskGet |
Retrieve full task details by ID |
TaskUpdate |
Update status, add comments, set blockers |
TaskList |
List all tasks with summary info |
Plus a battle-tested orchestrator skill — refined through millions of tokens of iteration — that teaches Claude how to effectively coordinate multiple agents working in parallel.
Quick Start
# Fastest path to a configured Claude Code variant npx cc-mirror quick --provider mirror --name mclaude # Run it mclaude
That's it. You now have a Claude Code variant ready to run.
Or use the interactive wizard
What is CC-MIRROR?
CC-MIRROR is an opinionated Claude Code distribution. We did the hacking — you get the superpowers.
At its core, CC-MIRROR:
- Clones Claude Code into isolated instances
- Configures provider endpoints, model mapping, and env defaults
- Applies prompt packs and tweakcc themes
- Installs optional skills (dev-browser)
- Packages everything into a single command
Each variant is completely isolated — its own config, sessions, MCP servers, and credentials. Your main Claude Code installation stays untouched.
┌─────────────────────────────────────────────────────────────────────────┐
│ ~/.cc-mirror/ │
│ │
│ ├── mclaude/ ← Mirror Claude │
│ │ ├── npm/ Claude Code installation │
│ │ ├── config/ API keys, sessions, MCP servers │
│ │ │ ├── tasks/<team>/ Team task storage (legacy) │
│ │ │ └── skills/orchestration/ Orchestrator skill (legacy) │
│ │ ├── tweakcc/ Theme customization │
│ │ └── variant.json Metadata │
│ │ │
│ ├── zai/ ← Z.ai variant (GLM models) │
│ └── minimax/ ← MiniMax variant (M2.1) │
│ │
│ Wrappers: <bin-dir>/mclaude, <bin-dir>/zai, ... │
└─────────────────────────────────────────────────────────────────────────┘
Default <bin-dir> is ~/.local/bin on macOS/Linux and ~/.cc-mirror/bin on Windows.
Windows tip: add %USERPROFILE%\\.cc-mirror\\bin to your PATH, or run the <variant>.cmd wrapper directly. Each wrapper has a sibling <variant>.mjs launcher.
Providers
Mirror Claude (Recommended)
The purest path to vanilla Claude Code. No proxy, no model changes — just clean isolation.
npx cc-mirror quick --provider mirror --name mclaude
- Direct Anthropic API — No proxy, authenticate normally (OAuth or API key)
- Isolated config — Experiment without affecting your main setup
- Provider presets — Clean defaults without hidden patches
Alternative Providers
Want to use different models? CC-MIRROR supports multiple providers:
| Provider | Models | Auth | Best For |
|---|---|---|---|
| Z.ai | GLM-4.7, GLM-4.5-Air | API Key | Heavy coding with GLM reasoning |
| MiniMax | MiniMax-M2.1 | API Key | Unified model experience |
| OpenRouter | 100+ models | Auth Token | Model flexibility, pay-per-use |
| CCRouter | Ollama, DeepSeek, etc. | Optional | Local-first development |
# Z.ai (GLM Coding Plan) npx cc-mirror quick --provider zai --api-key "$Z_AI_API_KEY" # MiniMax (MiniMax-M2.1) npx cc-mirror quick --provider minimax --api-key "$MINIMAX_API_KEY" # OpenRouter (100+ models) npx cc-mirror quick --provider openrouter --api-key "$OPENROUTER_API_KEY" \ --model-sonnet "anthropic/claude-sonnet-4-20250514" # Claude Code Router (local LLMs) npx cc-mirror quick --provider ccrouter
Legacy Orchestrator Skill (cc-mirror 1.6.3)
When team mode is enabled (cc-mirror 1.6.3), CC-MIRROR installs an orchestrator skill that teaches Claude how to coordinate work effectively.
The Conductor Identity
Claude becomes "The Conductor" — a warm, capable orchestrator who transforms ambitious requests into elegant execution:
┌─────────────────────────────────────────────────────────────────┐
│ │
│ You are the Conductor. Users bring the vision. │
│ You orchestrate the symphony of agents that makes it real. │
│ │
│ Complex work should feel effortless. │
│ That's your gift to every user. │
│ │
└─────────────────────────────────────────────────────────────────┘
What It Provides
| Aspect | What Claude Learns |
|---|---|
| Task Graph | Decompose work into tasks with dependencies |
| Parallel Execution | Fan-out, pipeline, map-reduce patterns |
| Background Agents | Spawn agents that work while you continue |
| Smart Prompting | Context, scope, constraints, output expectations |
| Progress Updates | Milestone celebrations, warm professional tone |
Example Flow
User: "Build me a REST API for todo management with tests"
Claude (The Conductor):
├── Clarifies requirements (AskUserQuestion with rich options)
├── Creates task graph with dependencies
├── Spawns background agents for parallel work:
│ ├── Agent 1: Database schema
│ ├── Agent 2: API routes (blocked by schema)
│ └── Agent 3: Test setup
├── Continues working while agents execute
├── Synthesizes results
└── Delivers unified output
Project-Scoped Tasks (Legacy: cc-mirror 1.6.3)
Legacy feature: available only in cc-mirror 1.6.3.
Tasks are automatically isolated by project folder — no cross-project pollution:
cd ~/projects/api && mclaude # Team: mclaude-api cd ~/projects/frontend && mclaude # Team: mclaude-frontend # Multiple teams in the same project TEAM=backend mclaude # Team: mclaude-myproject-backend TEAM=frontend mclaude # Team: mclaude-myproject-frontend
CLI Task Management (Legacy)
Manage team tasks from the command line:
npx cc-mirror tasks # List open tasks npx cc-mirror tasks --ready # List ready tasks (open + not blocked) npx cc-mirror tasks --json # JSON output for automation npx cc-mirror tasks show 18 # Show task details npx cc-mirror tasks create # Create new task npx cc-mirror tasks update 5 --status resolved npx cc-mirror tasks graph # Visualize dependencies npx cc-mirror tasks graph --json # Graph as JSON for programmatic use npx cc-mirror tasks clean --resolved # Cleanup done tasks
Team Mode Flags (Legacy: cc-mirror 1.6.3)
Team mode is enabled by default only in cc-mirror 1.6.3. In current builds, team mode is always disabled and these flags are ignored.
# Create without team mode (legacy) npx cc-mirror create --provider mirror --name vanilla --no-team-mode # Disable on existing variant npx cc-mirror update myvariant --disable-team-mode
Legacy (1.6.3) TUI toggle: Manage Variants → Toggle Team Mode
All Commands
# Create & manage variants npx cc-mirror # Interactive TUI npx cc-mirror quick [options] # Fast setup with defaults npx cc-mirror create [options] # Full configuration wizard npx cc-mirror list # List all variants npx cc-mirror update [name] # Update one or all variants npx cc-mirror remove <name> # Delete a variant npx cc-mirror doctor # Health check all variants npx cc-mirror tweak <name> # Launch tweakcc customization # Task management (legacy; cc-mirror 1.6.3) npx cc-mirror tasks # List open tasks npx cc-mirror tasks show <id> # Show task details npx cc-mirror tasks create # Create new task npx cc-mirror tasks update <id> # Update task npx cc-mirror tasks delete <id> # Delete task npx cc-mirror tasks archive <id> # Archive task npx cc-mirror tasks clean # Bulk cleanup npx cc-mirror tasks graph # Visualize dependencies # Launch your variant mclaude # Run Mirror Claude zai # Run Z.ai variant minimax # Run MiniMax variant
CLI Options
--provider <name> mirror | zai | minimax | openrouter | ccrouter | custom
--name <name> Variant name (becomes the CLI command)
--api-key <key> Provider API key
--base-url <url> Custom API endpoint
--model-sonnet <name> Map to sonnet model
--model-opus <name> Map to opus model
--model-haiku <name> Map to haiku model
--brand <preset> Theme: auto | zai | minimax | openrouter | ccrouter | mirror
--no-tweak Skip tweakcc theme
--no-prompt-pack Skip provider prompt pack
--verbose Show full tweakcc output during update
Brand Themes
Each provider includes a custom color theme via tweakcc:
| Brand | Style |
|---|---|
| mirror | Silver/chrome with electric blue |
| zai | Dark carbon with gold accents |
| minimax | Coral/red/orange spectrum |
| openrouter | Teal/cyan gradient |
| ccrouter | Sky blue accents |
Documentation
| Document | Description |
|---|---|
| Team Mode | Legacy team mode (cc-mirror 1.6.3) |
| Mirror Claude | Pure Claude Code with clean defaults |
| Architecture | How CC-MIRROR works under the hood |
| Full Documentation | Complete documentation index |
Related Projects
- tweakcc — Theme and customize Claude Code
- Claude Code Router — Route Claude Code to any LLM
- n-skills — Universal skills for AI agents
Contributing
Contributions welcome! See CONTRIBUTING.md for development setup.
Want to add a provider? Check the Provider Guide.
License
MIT — see LICENSE
Created by Numman Ali
@nummanali