{"id":35523880,"url":"https://github.com/numman-ali/cc-mirror","last_synced_at":"2026-02-15T01:19:48.211Z","repository":{"id":332208767,"uuid":"1126960247","full_name":"numman-ali/cc-mirror","owner":"numman-ali","description":"Create multiple isolated Claude Code variants with custom providers (Z.ai, MiniMax, OpenRouter, LiteLLM)","archived":false,"fork":false,"pushed_at":"2026-02-08T23:22:39.000Z","size":1278,"stargazers_count":1693,"open_issues_count":23,"forks_count":245,"subscribers_count":15,"default_branch":"main","last_synced_at":"2026-02-09T02:47:19.574Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/numman-ali.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-02T22:28:50.000Z","updated_at":"2026-02-09T02:05:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/numman-ali/cc-mirror","commit_stats":null,"previous_names":["numman-ali/cc-mirror"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/numman-ali/cc-mirror","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numman-ali%2Fcc-mirror","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numman-ali%2Fcc-mirror/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numman-ali%2Fcc-mirror/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numman-ali%2Fcc-mirror/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/numman-ali","download_url":"https://codeload.github.com/numman-ali/cc-mirror/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numman-ali%2Fcc-mirror/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29461460,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T22:42:09.113Z","status":"ssl_error","status_checked_at":"2026-02-14T22:42:05.053Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-04T00:26:16.799Z","updated_at":"2026-02-15T01:19:48.199Z","avatar_url":"https://github.com/numman-ali.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","others","🛠️ Tools \u0026 Utilities","Proxy \u0026 Customization"],"sub_categories":[],"readme":"# CC-MIRROR\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/cc-mirror-providers.png\" alt=\"CC-MIRROR Provider Themes\" width=\"800\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/cc-mirror\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/cc-mirror.svg\" alt=\"npm version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://twitter.com/nummanali\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/nummanali?style=social\" alt=\"Twitter Follow\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch2 align=\"center\"\u003eClaude Code, Unshackled\u003c/h2\u003e\n\n\u003cp align=\"center\"\u003e\n  Pre-configured Claude Code variants with custom providers,\u003cbr\u003e\n  prompt packs, and battle-tested enhancements.\u003cbr\u003e\u003cbr\u003e\n  \u003cstrong\u003eOne command. Instant power-up.\u003c/strong\u003e\n\u003c/p\u003e\n\n---\n\n## Quick Start\n\n```bash\n# Fastest path to a configured Claude Code variant\nnpx cc-mirror quick --provider mirror --name mclaude\n\n# Run it\nmclaude\n```\n\nThat's it. You now have a Claude Code variant ready to run.\n\n### Claude Code Version (Stable/Latest/Pin)\n\nBy default, CC-MIRROR installs the **latest** Claude Code native release. You can pin a channel or version:\n\n```bash\n# Track upstream stable channel\nnpx cc-mirror quick --provider mirror --name mclaude --claude-version stable\n\n# Track upstream latest channel\nnpx cc-mirror update mclaude --claude-version latest\n\n# Pin a specific version\nnpx cc-mirror update mclaude --claude-version 2.1.37\n```\n\nNotes:\n\n- `stable` and `latest` are upstream channels. `stable` may lag behind `latest` (that is normal).\n- cc-mirror resolves the channel to a concrete version during install/update and stores it in `variant.json`.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/cc-mirror-home.png\" alt=\"CC-MIRROR Home Screen\" width=\"600\"\u003e\n\u003c/p\u003e\n\n### Or use the interactive wizard\n\n```bash\nnpx cc-mirror\n```\n\n---\n\n## What is CC-MIRROR?\n\nCC-MIRROR is an **opinionated Claude Code distribution**. We did the hacking — you get the superpowers.\n\nAt its core, CC-MIRROR:\n\n1. **Clones** Claude Code into isolated instances\n2. **Configures** provider endpoints, model mapping, and env defaults\n3. **Applies** prompt packs and tweakcc themes\n4. **Installs** optional skills (dev-browser, opt-in)\n5. **Packages** everything into a single command\n\nEach variant is completely isolated — its own config, sessions, MCP servers, and credentials. Your main Claude Code installation stays untouched.\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│  ~/.cc-mirror/                                                          │\n│                                                                         │\n│  ├── mclaude/                        ← Mirror Claude                     │\n│  │   ├── native/                     Claude Code installation           │\n│  │   ├── config/                     API keys, sessions, MCP servers    │\n│  │   ├── tweakcc/                    Theme customization                │\n│  │   └── variant.json                Metadata                           │\n│  │                                                                      │\n│  ├── zai/                            ← Z.ai variant (GLM models)        │\n│  ├── minimax/                        ← MiniMax variant (M2.5)           │\n│  └── kimi/                           ← Kimi Code variant (kimi-for-coding) │\n│                                                                         │\n│  Wrappers: \u003cbin-dir\u003e/mclaude, \u003cbin-dir\u003e/zai, ...                        │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\nDefault `\u003cbin-dir\u003e` is `~/.local/bin` on macOS/Linux and `~/.cc-mirror/bin` on Windows.\n\n**Windows tip:** add `%USERPROFILE%\\\\.cc-mirror\\\\bin` to your `PATH`, or run the `\u003cvariant\u003e.cmd` wrapper directly. Each wrapper has a sibling `\u003cvariant\u003e.mjs` launcher.\n\n---\n\n## Providers\n\n### Mirror Claude (Recommended)\n\nThe purest path to vanilla Claude Code. No proxy, no model changes — just clean isolation.\n\n```bash\nnpx cc-mirror quick --provider mirror --name mclaude\n```\n\n- **Direct Anthropic API** — No proxy, authenticate normally (OAuth or API key)\n- **Isolated config** — Experiment without affecting your main setup\n- **Provider presets** — Clean defaults without hidden patches\n\n### Alternative Providers\n\nWant to use different models? CC-MIRROR supports multiple providers:\n\n| Provider       | Models                 | Auth       | Best For                        |\n| -------------- | ---------------------- | ---------- | ------------------------------- |\n| **Kimi**       | kimi-for-coding        | API Key    | Long-context coding (Kimi Code) |\n| **MiniMax**    | MiniMax-M2.5           | API Key    | Unified model experience        |\n| **Z.ai**       | GLM-5, 4.7, 4.5-Air    | API Key    | Heavy coding with GLM reasoning |\n| **OpenRouter** | 100+ models            | Auth Token | Model flexibility, pay-per-use  |\n| **Vercel**     | Multi-provider gateway | Auth Token | Vercel AI Gateway               |\n| **Ollama**     | Local + cloud models   | Auth Token | Local-first + hybrid setups     |\n| **NanoGPT**    | Claude Code endpoint   | Auth Token | Simple endpoint setup           |\n| **CCRouter**   | Ollama, DeepSeek, etc. | Optional   | Local-first development         |\n| **GatewayZ**   | Multi-provider gateway | Auth Token | Centralized routing             |\n\n### Provider Setup Links\n\n| Provider       | Subscribe                                                     | Get Key/Token                                                    | Docs                                                             |\n| -------------- | ------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- |\n| **Kimi**       | https://www.kimi.com/code                                     | https://www.kimi.com/code/console                                | https://www.kimi.com/code/docs/en/more/third-party-agents.html   |\n| **MiniMax**    | https://platform.minimax.io/subscribe/coding-plan             | https://platform.minimax.io/user-center/payment/coding-plan      | https://platform.minimax.io/docs                                 |\n| **Z.ai**       | https://z.ai/subscribe                                        | https://z.ai/manage-apikey/apikey-list                           | https://z.ai/docs                                                |\n| **OpenRouter** | https://openrouter.ai/account                                 | https://openrouter.ai/keys                                       | https://openrouter.ai/docs                                       |\n| **Vercel**     | https://vercel.com/ai                                         | https://vercel.com/account/tokens                                | https://vercel.com/docs/ai-gateway                               |\n| **Ollama**     | https://ollama.com                                            | https://ollama.com                                               | https://docs.ollama.com/api/anthropic-compatibility              |\n| **NanoGPT**    | https://nano-gpt.com                                          | https://nano-gpt.com                                             | https://docs.nano-gpt.com/docs/anthropic-compatibility           |\n| **CCRouter**   | https://github.com/musistudio/claude-code-router#installation | https://github.com/musistudio/claude-code-router#2-configuration | https://github.com/musistudio/claude-code-router#2-configuration |\n| **GatewayZ**   | https://gatewayz.ai                                           | https://gatewayz.ai                                              | https://docs.gatewayz.ai/docs/anthropic-compatibility            |\n\n```bash\n# Kimi Code (kimi-for-coding)\nnpx cc-mirror quick --provider kimi --api-key \"$KIMI_API_KEY\"\n\n# MiniMax (MiniMax-M2.5)\nnpx cc-mirror quick --provider minimax --api-key \"$MINIMAX_API_KEY\"\n\n# Z.ai (GLM-5/4.7/4.5-Air)\nnpx cc-mirror quick --provider zai --api-key \"$Z_AI_API_KEY\"\n\n# OpenRouter (100+ models)\nnpx cc-mirror quick --provider openrouter --api-key \"$OPENROUTER_API_KEY\" \\\n  --model-sonnet \"anthropic/claude-sonnet-4-20250514\"\n\n# Vercel AI Gateway\nnpx cc-mirror quick --provider vercel --api-key \"$VERCEL_AI_GATEWAY_KEY\" \\\n  --model-sonnet \"anthropic/claude-3-5-sonnet-20241022\"\n\n# Ollama\nnpx cc-mirror quick --provider ollama --api-key \"ollama\" \\\n  --model-sonnet \"qwen3-coder\" --model-opus \"qwen3-coder\" --model-haiku \"qwen3-coder\"\n\n# NanoGPT\nnpx cc-mirror quick --provider nanogpt --api-key \"$NANOGPT_API_KEY\"\n\n# CC Router (local LLMs)\nnpx cc-mirror quick --provider ccrouter\n\n# GatewayZ\nnpx cc-mirror quick --provider gatewayz --api-key \"$GATEWAYZ_API_KEY\" \\\n  --model-sonnet \"claude-3-5-sonnet-20241022\"\n```\n\n---\n\n## All Commands\n\n```bash\n# Create \u0026 manage variants\nnpx cc-mirror                     # Interactive TUI\nnpx cc-mirror quick [options]     # Fast setup with defaults\nnpx cc-mirror create [options]    # Full configuration wizard\nnpx cc-mirror list                # List all variants\nnpx cc-mirror update [name]       # Update one or all variants\nnpx cc-mirror apply \u003cname\u003e        # Re-apply tweakcc patches (no reinstall)\nnpx cc-mirror remove \u003cname\u003e       # Delete a variant\nnpx cc-mirror doctor              # Health check all variants\nnpx cc-mirror tweak \u003cname\u003e        # Launch tweakcc customization\n\n# Launch your variant\nmclaude                           # Run Mirror Claude\nzai                               # Run Z.ai variant\nminimax                           # Run MiniMax variant\nkimi                              # Run Kimi Code variant\n```\n\n---\n\n## CLI Options\n\n```\n--provider \u003cname\u003e        kimi | minimax | zai | openrouter | vercel | ollama | nanogpt | ccrouter | mirror | gatewayz | custom\n--name \u003cname\u003e            Variant name (becomes the CLI command)\n--api-key \u003ckey\u003e          Provider API key\n--base-url \u003curl\u003e         Custom API endpoint\n--model-sonnet \u003cname\u003e    Map to sonnet model\n--model-opus \u003cname\u003e      Map to opus model\n--model-haiku \u003cname\u003e     Map to haiku model\n--brand \u003cpreset\u003e         Theme: auto | kimi | minimax | zai | openrouter | vercel | ollama | nanogpt | ccrouter | mirror | gatewayz\n--no-tweak               Skip tweakcc theme\n--no-prompt-pack         Skip provider prompt pack\n--verbose               Show full tweakcc output during update\n```\n\n---\n\n## Brand Themes\n\nEach provider includes a custom color theme via [tweakcc](https://github.com/Piebald-AI/tweakcc):\n\n| Brand          | Style                            |\n| -------------- | -------------------------------- |\n| **kimi**       | Teal/cyan gradient               |\n| **minimax**    | Coral/red/orange spectrum        |\n| **zai**        | Dark carbon with gold accents    |\n| **openrouter** | Silver/chrome with electric blue |\n| **vercel**     | Monochrome with green accents    |\n| **ollama**     | Warm sandstone with earthy tones |\n| **nanogpt**    | Aurora green + cyan accents      |\n| **ccrouter**   | Sky blue accents                 |\n| **gatewayz**   | Violet gradients                 |\n\n---\n\n## Documentation\n\n| Document                                        | Description                          |\n| ----------------------------------------------- | ------------------------------------ |\n| [Mirror Claude](docs/features/mirror-claude.md) | Pure Claude Code with clean defaults |\n| [Architecture](docs/architecture/overview.md)   | How CC-MIRROR works under the hood   |\n| [Full Documentation](docs/README.md)            | Complete documentation index         |\n\n---\n\n## Related Projects\n\n- [tweakcc](https://github.com/Piebald-AI/tweakcc) — Theme and customize Claude Code\n- [Claude Code Router](https://github.com/musistudio/claude-code-router) — Route Claude Code to any LLM\n- [n-skills](https://github.com/numman-ali/n-skills) — Universal skills for AI agents\n\n---\n\n## Contributing\n\nContributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup.\n\n**Want to add a provider?** Check the [Provider Guide](docs/TWEAKCC-GUIDE.md).\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eCreated by \u003ca href=\"https://github.com/numman-ali\"\u003eNumman Ali\u003c/a\u003e\u003c/strong\u003e\u003cbr\u003e\n  \u003ca href=\"https://twitter.com/nummanali\"\u003e@nummanali\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnumman-ali%2Fcc-mirror","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnumman-ali%2Fcc-mirror","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnumman-ali%2Fcc-mirror/lists"}