English · 简体中文
A local desktop workbench for Claude Code, Codex, and your other AI coding agents.
Built on CC Switch.
English | 简体中文
Download v0.4.2 · Quick start · Why HRouter Desktop · Screenshots · Compared with CC Switch
Claude Code, Codex, Gemini CLI, Grok Build, OpenCode, and six more agents in one local app: providers, API keys, model mappings, backup routes, and usage. More screenshots.
Current release: v0.4.2 (2026-10-09).
| Platform | Package | Architecture |
|---|---|---|
| macOS | HRouter_0.4.2_aarch64.dmg | Apple Silicon (M-series) · macOS 12+ |
| Windows | HRouter_0.4.2_x64-setup.exe | x64 |
Intel Macs are not a supported install target. The published updater covers signed, notarized macOS Apple Silicon and Windows x64. After you install, the app can check for a newer release. Release notes · all versions.
Changelog · Code-signing policy
- Install v0.4.2. Open the workbench and select an agent. Claude Code and Codex are the usual starting points.
- Add a provider. Choose an official preset, or add a custom endpoint and API key. The app can inspect the provider's model catalog so you can review the models it can actually call. Keys are stored only in the local configuration.
- Review, save, and enable. Check the model mapping, then enable the provider. Refresh or restart the client if it was already open.
Official providers, a self-hosted endpoint, or another OpenAI-compatible LLM gateway all use the same workbench.
Different agents. Different config files. Different providers. Switching your coding setup should not mean piecing all of them together again.
HRouter Desktop puts the connection workflow in one place: providers, API keys, model mappings, configuration protection, backup routes, and usage. Built on CC Switch, it is a desktop CC Switch alternative: an agent-first interface for the services you choose, including official providers and OpenAI-compatible LLM gateways.
- 11 agents, one workbench. Move between Claude Code, Codex, Gemini CLI, and more without learning a different configuration UI for each.
- Switch with a preview, not a guess. Opt into Claude / Codex configuration protection to preserve custom fields, preview changes, and keep local switch snapshots.
- Give your models a backup plan. Choose primary and backup providers, define exact-model routes, and use automatic failover through supported local routing.
- Keep repeatable setups. Save provider, MCP, and Skill selections as access profiles; review them before applying.
- See how your tools are being used. Inspect requests, tokens, cache usage, and estimated costs, with an agent-scoped floating usage window.
- Use the service you want. Official providers, self-hosted endpoints, and compatible gateways are welcome.
- Provider library: official presets and custom endpoints, multiple saved providers per agent, editable keys and model mappings.
- Quick provider setup: key-based model discovery and agent-specific configuration, without a platform login.
- Connection checks: inspect the model catalog, then optionally test text responses, streaming, tool calls, and tool-result continuation. Real-request checks support Claude / Codex API-key providers and require acknowledgement of possible charges.
- Configuration protection: opt-in field-preserving Claude / Codex switching, change previews, local snapshots, and conflict-checked restore.
- Lite mode: focus on connection settings without application-managed MCP, Skills, or prompt writes. Includes prompt protection and provider-only sync scope.
- Access profiles: save and reapply provider, MCP, and Skill selections. Profiles reference your providers; they are not full configuration backups.
- Environment targets: preview and deploy supported Claude / Codex API-key configurations to existing Windows / WSL-accessible directories.
- Primary and backup routes: ordered failover queues and exact-model route chains through the local proxy. You choose the providers; nothing is added automatically.
- Usage analytics: request logs, token and cache breakdowns, trends, provider/model summaries, and local cost estimates.
- Provider usage: query configured provider usage interfaces; inspect multi-key quotas with explicit rules for combining independent balances.
- Desktop visibility: a floating agent usage window and macOS widget integration.
- Sessions: browse supported local agent conversations and resume work in the relevant client.
- MCP and Skills: manage shared resources with per-agent enablement, Skills discovery, and supported import/export and backup workflows.
- Agent-specific tools: OpenClaw workspace files, environment variables, tool permissions, and defaults; Hermes memory and user-profile editing.
- Everyday utilities: CLI installation/update entry points, language and theme preferences, and in-app help.
Claude Code · Claude Desktop · Codex · Gemini CLI · Grok Build · OpenCode · OpenClaw · Hermes · Pi Agent · DeepSeek Harness · WorkBuddy
Each agent has its own adapter. Routing, configuration protection, authentication, MCP, Skills, and usage support vary by agent; the CLI installer does not install every agent's desktop application. See the integration guide for scope and behavior.
Real macOS application captures with private configuration labels redacted. Some controls still display Chinese when the interface is set to English. Capture details and full image index.
| Providers in one place | Provider quick setup |
|---|---|
 |
 |
| Keep saved services and the active provider visible. | Discover models and review mappings before saving. |
| Reusable access profiles | Explicit backup routes |
|---|---|
 |
 |
| Save a setup you can return to. | Choose the order in which providers are tried. |
Configuration protection, MCP, Skills, and desktop usage
| Protect local configuration | Manage MCP resources |
|---|---|
 |
 |
CC Switch provides the foundation. HRouter Desktop changes how you work with it. We retain the upstream provider, proxy, MCP, Skills, session, and usage foundations rather than presenting them as new inventions.
| Focus | What this fork changes |
|---|---|
| Agent-first interface | A redesigned workbench and top navigation, with dedicated Configuration, Profiles, Route policies, and Usage pages. |
| Deliberate configuration changes | A protection workflow with previews, fingerprint checks, snapshots, guarded restores, Lite mode, and prompt protection. |
| Repeatable access setups | Dedicated profiles for provider, MCP, and Skill selections, with a preview before application. |
| Model-aware routing | Extensions to inherited routing: exact-model primary/backup chains, temporary manual preferences, and controlled multi-key quota aggregation. |
| Compatibility and continuity | Protocol-aware connection checks, targeted proxy transport fixes, and Codex legacy-provider compatibility without rewriting conversation history. |
| Usage correctness | Targeted fixes for Codex fork usage, Claude cache-TTL estimates, and OpenCode rollup/deduplication. |
| Desktop integration | DeepSeek Harness / WorkBuddy integration work, and agent-scoped desktop usage tools. |
| A focused desktop | v0.4.0 removes the account, payment, order, and cloud-billing modules from earlier HRouter versions—not from CC Switch. |
This is a summary of changes maintained in this fork, not a claim that current upstream lacks every listed capability. The projects evolve independently. For implementation details and validation limits, see the workbench guide, fix checklist, and upstream contribution records.
- Install and choose an agent. Open the workbench and select the coding tool you want to configure.
- Connect a service. Add a provider preset or a custom endpoint and key, and review the discovered models.
- Review, save, and enable. Check the model mapping and configuration, then enable the provider. Refresh or restart the target client if required.
That's the basic setup. Add protection, profiles, or backup routes when you need them; opt into a billable connection test only after checking the catalog.
Use Agents → Connect → Import from CC Switch to preview your actual cc-switch.db file read-only and select providers to import. The importer does not change the source database, overwrite existing entries, or activate imported providers.
This imports providers—not a whole account. Managed OAuth sessions, prompts, Skills, usage scripts, and OMO configuration are excluded. Existing HRouter users do not need to delete their keys or configuration directories to upgrade.
- Local-first, not offline-only. Provider calls, model discovery, usage queries, Skills discovery, pricing, and updates contact the relevant services. Treat local keys, configuration files, and snapshots as sensitive.
- Estimates, not invoices. Usage depends on available local records and configured prices. A passing connection check is not a guarantee of model identity, quality, or long-task reliability.
- Protection has a scope. It is opt-in for Claude / Codex. Restore checks preserve later edits rather than forcing an overwrite; provider-only sync and profiles are not full backups.
- Signing types differ. Tauri updater signatures are not Windows Authenticode signatures. macOS publication requires Developer ID signing and notarization.
Built with Tauri 2 · Rust · React · TypeScript. Use the project lockfile, pnpm@10.12.3, and your platform's Tauri build prerequisites.
git clone https://github.com/honestTai/HRouter-Desktop.git
cd HRouter-Desktop
pnpm install --frozen-lockfile
pnpm devpnpm build builds for the host platform. See Contributing for checks and contribution guidelines, and macOS signing for release setup.
Found a bug or have a workflow to improve? Open an issue. If HRouter Desktop is useful to you, give the repository a star.
Based on CC Switch by Jason Young and its contributors. HRouter Desktop is independently maintained by honestTai and HRouter Contributors; it is not an official CC Switch release or endorsed by its maintainers.
The original copyright and MIT license are preserved. Some internal cc-switch identifiers remain for compatibility and migration.
Star / Fork totals and retained-event history, scheduled to refresh daily.
Observed daily totals · Methodology · All public projects
Historical curves reconstruct currently retained stars and visible forks, not historical net totals. Separate daily observations start on 2026-10-06; no fabricated backfill.