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

Create multiple isolated Claude Code variants with custom providers.

What is CC-MIRROR?

┌────────────────────────────────────────────────────────────────────────────────┐
│                                                                                │
│   One tool. Multiple Claude Code instances. Complete isolation.                │
│                                                                                │
│   ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐   │
│   │   zai    │   │ minimax  │   │openrouter│   │ ccrouter │   │ mclaude  │   │
│   │  GLM-4.7 │   │  M2.1    │   │ 100+ LLMs│   │  Local   │   │  Claude  │   │
│   └────┬─────┘   └────┬─────┘   └────┬─────┘   └────┬─────┘   └────┬─────┘   │
│        │              │              │              │              │          │
│        └──────────────┴──────────────┴──────────────┴──────────────┘          │
│                                      │                                         │
│                           ┌──────────▼──────────┐                             │
│                           │    Claude Code      │                             │
│                           │    (isolated)       │                             │
│                           └─────────────────────┘                             │
│                                                                                │
└────────────────────────────────────────────────────────────────────────────────┘

CC-MIRROR creates isolated Claude Code instances that connect to different AI providers. Each variant has its own config, sessions, themes, and API credentials — completely separate from each other.

⚡ Quick Start

# Run the interactive TUI
npx cc-mirror

# Or quick setup from CLI
npx cc-mirror quick --provider zai --api-key "$Z_AI_API_KEY"

CC-MIRROR Home Screen

🔌 Supported 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
Mirror	Claude (native)	OAuth/Key	Pure Claude with team mode

# 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-3.5-sonnet"

# Claude Code Router (local LLMs)
npx cc-mirror quick --provider ccrouter

# Mirror Claude (pure Claude with team mode)
npx cc-mirror quick --provider mirror --name mclaude

📁 How It Works

Each variant lives in its own directory with complete isolation:

┌─────────────────────────────────────────────────────────────────────────┐
│  ~/.cc-mirror/                                                          │
│                                                                         │
│  ├── zai/                          ← Your Z.ai variant                  │
│  │   ├── npm/                      Claude Code installation             │
│  │   ├── config/                   API keys, sessions, MCP servers      │
│  │   ├── tweakcc/                  Theme & prompt customization         │
│  │   └── variant.json              Metadata                             │
│  │                                                                      │
│  ├── minimax/                      ← Your MiniMax variant               │
│  │   └── ...                                                            │
│  │                                                                      │
│  └── mclaude/                      ← Your Mirror Claude variant         │
│      └── ...                                                            │
│                                                                         │
│  Wrappers: ~/.local/bin/zai, ~/.local/bin/minimax, ~/.local/bin/mclaude │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Run any variant directly from your terminal:

zai          # Launch Z.ai variant
minimax      # Launch MiniMax variant
mclaude      # Launch Mirror Claude variant

✨ Features

Feature	Description
🔌 Multiple Providers	Z.ai, MiniMax, OpenRouter, CCRouter, Mirror, or custom endpoints
📁 Complete Isolation	Each variant has its own config, sessions, and credentials
🎨 Brand Themes	Custom color schemes per provider via tweakcc
📝 Prompt Packs	Enhanced system prompts for Z.ai and MiniMax
🤖 Team Mode	Multi-agent collaboration with shared task management
📋 Tasks CLI	Manage, archive, and visualize task dependencies from command line
🔄 One-Command Updates	Update all variants when Claude Code releases

🛠️ Commands

# Create & manage variants
npx cc-mirror create              # Full configuration wizard
npx cc-mirror quick [options]     # Fast setup with defaults
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

# Task management (team mode)
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
zai                           # Run Z.ai variant
minimax                       # Run MiniMax variant
mclaude                       # Run Mirror Claude variant

🎛️ CLI Options

--provider <name>        zai | minimax | openrouter | ccrouter | mirror | 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 (OpenRouter)
--model-opus <name>      Map to opus model (OpenRouter)
--model-haiku <name>     Map to haiku model (OpenRouter)
--brand <preset>         Theme: auto | zai | minimax | openrouter | ccrouter | mirror
--enable-team-mode       Enable team mode (TaskCreate, TaskGet, TaskUpdate, TaskList)
--no-tweak               Skip tweakcc theme
--no-prompt-pack         Skip prompt pack

🎨 Brand Themes

Each provider includes a custom color theme:

Brand	Style
zai	Dark carbon with gold accents
minimax	Coral/red/orange spectrum
openrouter	Teal/cyan gradient
ccrouter	Sky blue accents
mirror	Silver/chrome with electric blue

🤖 Team Mode

Enable multi-agent collaboration with shared task management:

# Enable on any variant
npx cc-mirror create --provider zai --name zai-team --enable-team-mode

# Mirror Claude has team mode by default
npx cc-mirror quick --provider mirror --name mclaude

Team mode enables: TaskCreate, TaskGet, TaskUpdate, TaskList tools plus an orchestrator skill that teaches Claude effective multi-agent coordination patterns.

Tasks CLI (v1.4.0+)

Manage team tasks from the command line:

# List open tasks
npx cc-mirror tasks

# View across all teams
npx cc-mirror tasks --all

# Create and update tasks
npx cc-mirror tasks create --subject "Add auth" --description "JWT implementation"
npx cc-mirror tasks update 5 --status resolved --add-comment "Done"

# Cleanup resolved tasks
npx cc-mirror tasks clean --resolved --dry-run
npx cc-mirror tasks clean --resolved --force

# Archive instead of delete (preserves task history)
npx cc-mirror tasks archive 5

# Visualize dependency graph
npx cc-mirror tasks graph

Project-Scoped Tasks (v1.2.0+)

Tasks are automatically scoped by project folder — no cross-project pollution:

# Run in different project folders - tasks stay isolated
cd ~/projects/api && mc      # Team: mc-api
cd ~/projects/frontend && mc # Team: mc-frontend

# Multiple teams in the same project
TEAM=backend mc   # Team: mc-myproject-backend
TEAM=frontend mc  # Team: mc-myproject-frontend

→ Team Mode Documentation

🪞 Mirror Claude

A pure Claude Code variant with enhanced features:

No proxy — Connects directly to Anthropic's API
Team mode — Enabled by default
Isolated config — Experiment without affecting your main setup
Custom theme — Silver/chrome aesthetic

npx cc-mirror quick --provider mirror --name mclaude
mclaude  # Authenticate via OAuth or API key

→ Mirror Claude Documentation

📚 Documentation

Document	Description
Team Mode	Multi-agent collaboration with shared tasks
Mirror Claude	Pure Claude Code with enhanced features
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