Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (cc-mirror) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

CC-MIRROR

CC-MIRROR Provider Themes

Claude Code, Unshackled

Pre-configured Claude Code variants with multi-agent orchestration,
custom providers, and battle-tested enhancements.

One command. Instant power-up.

The Unlock

Claude Code has a hidden multi-agent capability. CC-MIRROR enables it.

┌─────────────────────────────────────────────────────────────────────────────┐
│                                                                             │
│   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 multi-agent Claude Code
npx cc-mirror quick --provider mirror --name mclaude

# Run it
mclaude

That's it. You now have Claude Code with team mode enabled.

CC-MIRROR Home Screen

Or use the interactive wizard

npx cc-mirror

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
Patches the CLI to enable hidden features (team mode)
Installs battle-tested skills (orchestrator, browser automation)
Configures provider-specific enhancements
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 (team mode)        │
│  │   ├── npm/                        Claude Code installation           │
│  │   ├── config/                     API keys, sessions, MCP servers    │
│  │   │   ├── tasks/<team>/           Team task storage                  │
│  │   │   └── skills/orchestration/   Orchestrator skill                 │
│  │   ├── tweakcc/                    Theme customization                │
│  │   └── variant.json                Metadata                           │
│  │                                                                      │
│  ├── zai/                            ← Z.ai variant (GLM models)        │
│  └── minimax/                        ← MiniMax variant (M2.1)           │
│                                                                         │
│  Wrappers: ~/.local/bin/mclaude, ~/.local/bin/zai, ...                  │
└─────────────────────────────────────────────────────────────────────────┘

Providers

Mirror Claude (Recommended)

The purest path to multi-agent Claude Code. No proxy, no model changes — just Claude with superpowers.

npx cc-mirror quick --provider mirror --name mclaude

Direct Anthropic API — No proxy, authenticate normally (OAuth or API key)
Team mode enabled — The hidden tools, unlocked
Orchestrator skill — Battle-tested multi-agent coordination
Isolated config — Experiment without affecting your main setup

Alternative Providers

Want to use different models? CC-MIRROR supports multiple providers, all with team mode:

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

The Orchestrator Skill

When team mode is enabled, 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

Full Team Mode Documentation

Project-Scoped Tasks

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

Manage team tasks from the command line:

npx cc-mirror tasks                    # List open tasks
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 clean --resolved   # Cleanup done tasks

Disabling Team Mode

Team mode is enabled by default on all variants. If you want vanilla Claude Code behavior:

# Create without team mode
npx cc-mirror create --provider mirror --name vanilla --no-team-mode

# Disable on existing variant
npx cc-mirror update myvariant --disable-team-mode

Or toggle via the TUI: 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
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-team-mode           Disable team mode (not recommended)
--no-tweak               Skip tweakcc theme
--no-prompt-pack         Skip provider prompt pack

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	Multi-agent collaboration deep dive
Mirror Claude	Pure Claude Code with superpowers
Architecture	How CC-MIRROR works under the hood
Full Documentation	Complete documentation index

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

cc-mirror