Use your AI accounts from one place, and see which account handled each request. HoV Router connects Claude Code to your chosen providers, routes requests across available accounts, and shows usage, costs, and errors in a dashboard. Run one Router privately over Tailscale for several computers, or start with one local computer.
HoV Router is a fork of tombii/better-ccflare. Thanks to tombii and the better-ccflare contributors for the router it builds on. Since the fork it has added banked-reset tracking, Codex route pools that follow a model line, per-provider health reporting and a Linux binary with signed build provenance, and it moved SQLite's heavy reads and writes onto worker threads.
Copy this into Claude Code or another coding agent with access to your computer and terminal. A chat-only assistant can explain the steps, but can't install Router for you.
Help me set up HoV Router for Claude Code.
Read https://github.com/StartupBros/hov-router/blob/main/docs/agent-setup.md
First determine whether to connect to an existing Router or host a new one.
Reuse an existing Router instead of installing another or repeating provider
setup. Preserve my working settings and login. Ask before paid usage,
authentication changes, or server changes.
Do the setup you can; leave browser sign-in, MFA, and private credentials to me,
without secrets in chat. Verify a real request used the intended account and
model, with the owner's help if needed. Report missing evidence or human steps
as pending, not done. Show me how to launch and undo the client setup without
disrupting a shared server.
Your agent handles the technical steps; you supply any private access details. Already have a Router? Use shared-client setup. Tailscale connects the computers; it does not replace Router authentication. Starting your first Router? Use the manual installation instructions.
With two coding accounts, the Router owner adds them and reviews their routing order. Claude Code sends a request; Router picks an eligible account. If that account becomes unavailable, Router can try another eligible account under your routing settings. In Requests, you can check the account, model, and outcome rather than guess where the request went.
Router doesn't create more quota or make a paid provider free. If every eligible account is unavailable, the request can still fail. Provider access, billing, and usage rules still apply.
Watch the dashboard walkthrough.
Shared clients need Claude Code and access to the confirmed server, not a Router binary. The limits below concern the server, not the client OS.
- Linux x86_64: HoV Router 5.1.0 has a standalone binary with a pinned checksum and signed build provenance. It doesn't need Node.js or Bun to run.
- Source builds: instructions use a POSIX shell on Linux/macOS, or WSL on Windows, with Git, Node.js, and Bun 1.4.2. The source-install acceptance check runs on Linux x86_64; macOS and native Windows installation have not been verified here.
- Other distributions: Router does not publish npm packages, container images, or binaries for other platforms. The upstream better-ccflare packages and downloads are a different distribution.
Use hov-router; older command names such as better-ccflare remain compatible, with unchanged storage/configuration names. See migration and rollback. The repository was renamed to StartupBros/hov-router on 2026-10-21; it is the same repository, not a new fork.
Start with troubleshooting or the documentation index for configuration, providers, routing, and deployment. Report Router problems at StartupBros/hov-router/issues. Include your platform, version, and the failing step; remove credentials and private request content.
Issues and pull requests are welcome. For non-trivial changes, open an issue first to agree on the approach. See the contribution guide.
HoV Router continues tombii/better-ccflare and its ancestor snipeship/ccflare. Their work and the community's contributions remain credited in the full acknowledgements, including upstream sponsors.
Related: hov-stack, the Claude Code setup House of Vibe works in. HoV Router and hov-stack are independent; neither requires the other.
MIT - See LICENSE for details.
Maintained by Will Mitchell at House of Vibe.