v2.0.1

Fixes

• Windows: invoke tweakcc via cmd.exe + npx.cmd so variant creation/update works reliably when npx isn’t directly executable.
• Windows: best-effort PATH update to include the variant bin dir (skips in CI; disable with CC_MIRROR_DISABLE_PATH_UPDATE=1).
• Windows: improved tilde expansion (~\\) and list now expands tilde before reading variants.
• Docs: corrected Windows PATH examples (avoid double-escaped backslashes).

CI / Dev

• CI: Windows end-to-end smoke test on every PR (bundle + quick create + list/doctor + wrapper).
• Tests: regression coverage for Windows tweakcc execution and tilde expansion.
• Lint: fixed an unused variable in scripts/preview-splash-grid.mjs (macOS CI).

v2.0.0 — Claude Code, Unshackled

Breaking Changes

• Native-only installs — Removed npm-based Claude Code installation entirely. All variants now use the native binary. Existing npm/ directories are ignored; run cc-mirror update to migrate.
• Team mode removed — The team mode feature has been removed to reduce complexity.
• Prompt pack mode — Only minimal mode is supported. The maximal mode has been deprecated.

New Providers

• Kimi Code — Moonshot AI's long-context coding assistant (kimi-for-coding / K2.5)
• Ollama — Local model runner with Anthropic-compatible API
• GatewayZ — Multi-provider AI gateway
• Vercel AI Gateway — Vercel's multi-provider gateway
• NanoGPT — Pay-per-token Claude Code endpoint
• CC Router — Route Claude Code to any LLM (Ollama, DeepSeek, etc.)

Features

• Unique brand themes for every provider — Each provider has its own color palette, ASCII splash art, and custom thinking verbs
• Adaptive diff palettes — Diff colors now match each brand's color scheme for better readability
• Model overrides in TUI — Configure Sonnet/Opus/Haiku model mappings for all providers via the interactive wizard
• --claude-version support — Pin or update native Claude Code versions (stable, latest, or specific version)
• Default to latest channel — New variants track the latest Claude Code release by default
• --model convenience flag — Set all model tiers at once from CLI
• Social media grid preview — scripts/preview-splash-grid.mjs renders a 3x3 grid of all provider splash banners

Improvements

• OpenRouter Chrome theme — Upgraded from navy to polished silver/chrome aesthetic
• CC Router renamed — "Claude Code Router" shortened to "CC Router" across UI
• Mirror provider hidden — Now marked as experimental (development reference only)
• Tool denies via settings.json — Provider tool restrictions moved from tweakcc toolsets to settings.json permissions.deny for reliability
• Simplified splash art — Cleaner, tighter ASCII art for OpenRouter, Vercel, CCRouter, and GatewayZ
• Long API key paste fix — TUI masked input now preserves full key across multiple paste chunks
• Provider list viewport — Constrained scrolling for cleaner TUI navigation

Internal

• Legacy tweakcc toolset migration for existing variants
• Dark theme enforced as default for Rust native module compatibility
• Normalized variant metadata schema

v1.6.6

1.6.6\n\n### Changed\n- Default Claude Code npm version updated to 2.1.12.\n- Team mode is disabled in current builds; legacy flags are ignored.\n\n### Added\n- Team mode cleanup during updates when legacy metadata is detected.\n\n### Documentation\n- README and docs now mark team mode as legacy (cc-mirror 1.6.3 only).\n\n## 1.6.5\n\n### Changed\n- Default Claude Code npm version updated to 2.1.5.\n\n## 1.6.4\n\n### Changed\n- cc-mirror update now resets npm/ and tweakcc/ before reinstalling, preserving config/tasks/skills for a clean rebuild.\n- Update command defaults to quiet tweakcc output; use --verbose to show full logs.\n\n### Added\n- Update rebuild step test coverage, plus a gated live E2E update smoke test for headless CLI runs.\n\n### Fixed\n- Update no longer reuses stale tweakcc prompt data that could corrupt the CLI after upgrades.\n

v1.5.0 - Claude Code, Unshackled

Claude Code, Unshackled

Complete messaging overhaul positioning CC-MIRROR as an opinionated Claude Code distribution with multi-agent orchestration as the flagship feature.

Highlights

• New tagline: "Claude Code, Unshackled" — pre-configured variants with multi-agent orchestration, custom providers, and battle-tested enhancements
• Mirror Claude is now the recommended provider — the fastest path to multi-agent Claude Code
• Team mode is the flagship feature — unlocks TaskCreate, TaskGet, TaskUpdate, TaskList tools + battle-tested orchestrator skill

Quick Start

# Fastest path to multi-agent Claude Code
npx cc-mirror quick --provider mirror --name mclaude

# Run it
mclaude

What Changed

README Rewrite

• New hero section: "The Unlock" explains what CC-MIRROR enables
• Before/after ASCII diagram showing the transformation
• Mirror Claude Quick Start at the top
• "What is CC-MIRROR?" section explains the opinionated distribution model

CLI & TUI Updates

• CLI help: New header, "THE UNLOCK" section, PROVIDERS list
• TUI logo: "Claude Code, Unshackled" + "Multi-agent orchestration. One command."
• Provider select: Mirror highlighted as fastest path
• All providers now show multi-agent orchestration as a feature

Provider Changes

• Mirror is now first in all provider lists
• Updated descriptions emphasize multi-agent capabilities
• All providers have team mode enabled by default

---

Full Changelog: v1.4.2...v1.5.0

v1.4.2 - Model Selection & npx Portability

Model Selection for Orchestration Skill

Every Task() call in the orchestration skill now includes an explicit model= parameter with clear guidance on when to use each tier.

Model Tier Framework

Model	Best For
haiku	Exploration, searching, fetching context, data discovery - spawn many
sonnet	Implementation, test generation, documentation, structured work
opus	Code review, security analysis, architecture, conflict resolution

The Mental Model

• Haiku = "errand runner" — spawn wildly, gather info, no judgment
• Sonnet = "junior-mid engineer" — well-structured tasks, clear direction needed
• Opus = "critical thinker" — trust its judgment, ambiguous problems, architecture

All Commands Now Portable with npx

All command examples across the codebase now use npx cc-mirror instead of cc-mirror for maximum portability - no global install required!

Updated guidance in:

• Task Manager skill
• README.md
• Team Mode docs
• CLI help text
• AGENTS.md
• Architecture docs
• Issue templates

Changes

• Added Model Selection section to SKILL.md with tier descriptions
• Updated 12 skill reference files with explicit model= parameters
• Updated all CLI command examples to use npx cc-mirror
• 22 files updated for consistency

---

Full Changelog: v1.4.0...v1.4.2

v1.4.1 - Explicit Model Selection & npx Portability

Model Selection for Orchestration Skill

Every Task() call in the orchestration skill now includes an explicit model= parameter with clear guidance on when to use each tier.

Model Tier Framework

Model	Best For
haiku	Exploration, searching, fetching context, data discovery - spawn many
sonnet	Implementation, test generation, documentation, structured work
opus	Code review, security analysis, architecture, conflict resolution

The Mental Model

• Haiku = "errand runner" — spawn wildly, gather info, no judgment
• Sonnet = "junior-mid engineer" — well-structured tasks, clear direction needed
• Opus = "critical thinker" — trust its judgment, ambiguous problems, architecture

All Commands Now Portable with npx

All command examples across the codebase now use npx cc-mirror instead of cc-mirror for maximum portability - no global install required!

Updated guidance in:

• Task Manager skill
• README.md
• Team Mode docs
• CLI help text
• AGENTS.md
• Architecture docs
• Issue templates

Changes

• Added Model Selection section to SKILL.md with tier descriptions
• Updated 12 skill reference files with explicit model= parameters
• Updated all CLI command examples to use npx cc-mirror
• 22 files updated for consistency

---

Full Changelog: v1.4.0...v1.4.1

v1.4.0 - Tasks CLI

Tasks CLI for Team Mode Management

Comprehensive command-line interface for managing team tasks outside of Claude Code.

New Commands

cc-mirror tasks               # List open tasks
cc-mirror tasks show <id>     # Show task details
cc-mirror tasks create        # Create new task
cc-mirror tasks update <id>   # Update task status/comments
cc-mirror tasks delete <id>   # Permanently delete task
cc-mirror tasks archive <id>  # Archive task (preserves history)
cc-mirror tasks clean         # Bulk cleanup resolved/old tasks
cc-mirror tasks graph         # Visualize task dependencies

Features

• Smart auto-detection: Automatically detects variant and team from CLAUDE_CONFIG_DIR env var
• Archive support: Move tasks to archive/ folder instead of permanent deletion
• Dependency graph: ASCII visualization of task blocking relationships
• Bulk cleanup: --resolved, --older-than <days>, --dry-run options
• Cross-team view: --all flag to see tasks across all teams
• JSON output: --json flag for scripting

New Skill

The task-manager skill is now auto-installed when team mode is enabled. This teaches agents about the CLI for cleanup and visualization tasks.

Bug Fixes

• Fixed args parser consuming next argument for boolean flags (--dry-run --variant mc now works correctly)

Full Changelog

v1.3.0...v1.4.0

v1.0.4 - UI Cleanup & Prompt Pack Improvements

Changes

• Removed broken ASCII art success banner from completion screen
• Streamlined Z.ai prompt pack (removed verbose setup/advanced sections)
• Simplified MiniMax prompt pack (removed redundant auth section)

Installation

npx cc-mirror

Full Changelog: v1.0.3...v1.0.4

v1.0.3 - Dependency Cleanup

Changes

• Removed 5 unused dependencies: gradient-string, ink-big-text, ink-box, ink-gradient, ink-spinner
• Production dependencies reduced from 10 to 5
• Package tarball size: 88.5 kB

Fixes

• Fixed bin path to use relative path (./dist/cc-mirror.mjs)
• Added missing @eslint/js dev dependency

Installation

npx cc-mirror
# or
npm install -g cc-mirror

Full Changelog: v1.0.0...v1.0.3

CC-MIRROR v1.0.0

CC-MIRROR v1.0.0 — First Public Release 🎉

Create multiple isolated Claude Code variants with custom providers.

Highlights

• Interactive TUI — Just run cc-mirror (no flags needed!)
• 4 Providers — Z.ai, MiniMax, OpenRouter, Claude Code Router
• Brand Themes — Custom color schemes per provider
• Prompt Packs — Enhanced system prompts for Z.ai and MiniMax
• One-Command Updates — Update all variants when Claude Code releases

Installation

npm install -g cc-mirror
cc-mirror

What's New

Added

• First public release
• Claude Code Router support (route to local LLMs via CCRouter)
• RouterUrlScreen for simplified CCRouter configuration
• Provider intro screens with setup guidance and feature highlights
• Feedback screen with GitHub repository links
• Beautiful README with screenshots

Changed

• TUI opens by default (no --tui flag required)
• Removed LiteLLM provider (replaced by Claude Code Router)
• CCRouter no longer requires model mapping
• Simplified provider selection flow

Fixed

• All linting errors resolved
• React hook dependency warnings fixed
• Settings-only updates preserve binary patches

---

🤖 Built with Claude Code

Created by Numman Ali • @nummanali