HRouter-Desktop

skill
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

A local-first desktop workbench for AI coding agents: providers, keys, models, profiles, routing and usage. Optional HRouter key quick setup. Built on CC Switch.

README.md
HRouter Desktop

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.

HRouter · Docs · Contact

English · 简体中文

Quick start

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.

  1. Install v0.4.2. Open the workbench and select an agent. Claude Code and Codex are the usual starting points.
  2. 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.
  3. 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. HRouter is the companion relay for prepaid model access. One API key covers Claude, GPT, Gemini, and Grok for your coding agents.

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.

Built with Tauri 2 · Rust · React · TypeScript. Use the project lockfile and [email protected].

git clone https://github.com/honestTai/HRouter-Desktop.git
cd HRouter-Desktop
pnpm install --frozen-lockfile
pnpm dev

pnpm build builds for the host platform.

Core features

Area What it does
Providers Official presets and custom endpoints, multiple saved providers per agent, editable keys and model mappings
Configuration protection Opt-in field-preserving Claude / Codex switching, change previews, local snapshots, and conflict-checked restore
Routes Primary and backup providers, exact-model route chains, and automatic failover through supported local routing. You choose the providers; nothing is added automatically
Usage Request logs, token and cache breakdowns, trends, provider/model summaries, and local cost estimates
Profiles and workspace Save and reapply provider, MCP, and Skill selections. Browse supported local sessions and manage MCP and Skills

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. See the integration guide.

Docs

License

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.

MIT License · Attribution

We retain the upstream provider, proxy, MCP, Skills, session, and usage foundations rather than presenting them as new inventions. Records: upstream contributions.

Star history

Star history


Reviews (0)

No results found