Skip to content
Back to search

bitrouter

The minimal interpretable model router that learns & adapts to your agent workflows

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/bitrouter/bitrouter with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/bitrouter/bitrouter'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bitrouter--bitrouter/badge.svg)](/listings/bitrouter--bitrouter)

HTML

<a href="/listings/bitrouter--bitrouter"><img src="/api/listings/bitrouter--bitrouter/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

# macOS / Linux
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/bitrouter/bitrouter/releases/download/v1.0.0-alpha.33/bitrouter-installer.sh | sh

# Homebrew
brew install bitrouter/tap/bitrouter

# Windows
powershell -ExecutionPolicy Bypass -Command "irm https://github.com/bitrouter/bitrouter/releases/download/v1.0.0-alpha.33/bitrouter-installer.ps1 | iex"

# npm
npm install -g bitrouter

# From source (Cargo)
cargo install bitrouter

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "bitrouter",
  3. "description": "BitRouter's official plugin marketplace — the agent plugin ships from the same repo as the router itself.",
  4. "owner": { "name": "BitRouterAI", "url": "https://bitrouter.ai" },
  5. "plugins": [
  6. {
  7. "name": "bitrouter",
  8. "source": "./",
  9. "description": "Cost-optimize your agentic loops with the BitRouter setup and operations skill, including independent input-check service setup and migration."
  10. }
  11. ]
  12. }
README.md · README · 199 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # BitRouter
  2. [![Build status](https://github.com/bitrouter/bitrouter/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/bitrouter/bitrouter/actions)
  3. [![Crates.io](https://img.shields.io/crates/v/bitrouter)](https://crates.io/crates/bitrouter)
  4. [![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
  5. [![Twitter](https://img.shields.io/badge/Twitter-black?logo=x&logoColor=white)](https://x.com/BitRouterAI)
  6. [![Discord](https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white)](https://discord.gg/G3zVrZDa5C)
  7. [![Hugging Face](https://img.shields.io/badge/Hugging_Face-FFD21E?logo=huggingface&logoColor=black)](https://huggingface.co/BitRouterAI)
  8. [![Docs](https://img.shields.io/badge/Docs-bitrouter.ai-green)](https://bitrouter.ai)
  9. [![LinkedIn](https://img.shields.io/badge/LinkedIn-0A66C2?logo=linkedin&logoColor=white)](https://www.linkedin.com/company/bitrouterai/?viewAsMember=true)
  10. [![Book a call](https://img.shields.io/badge/Book_a_call-founders-000000?logo=cal.com&logoColor=white)](https://cal.com/kelsenliu)
  11. **The minimal interpretable model router that learns & adapts to your agent workflows.**
  12. Point an OpenAI-compatible agent at your local BitRouter instance and choose
  13. `bitrouter/auto` after configuring an `auto` router and policy. See the
  14. [routing guide](https://bitrouter.ai/docs/models-routing/bitrouter-auto) for setup.
  15. ```diff
  16. - OPENAI_BASE_URL=https://api.openai.com/v1
  17. + OPENAI_BASE_URL=http://localhost:4356/v1
  18. ```
  19. Then set the request model to:
  20. ```text
  21. bitrouter/auto
  22. ```
  23. BitRouter runs locally and exposes an OpenAI-compatible API, so existing agents and tools can switch over with minimal changes.
  24. You can also give your coding agent the `/bitrouter` skill to install, configure, migrate to, and troubleshoot BitRouter for you:
  25. ```bash
  26. npx skills add bitrouter/bitrouter
  27. ```
  28. > **[Try BitRouter Cloud →](https://cloud.bitrouter.ai):** Use `https://api.bitrouter.ai/v1` with a Cloud credential and a catalog model ID. Hosted routing presets use `@<name>`; the local `bitrouter/auto` selector requires a local router.
  29. ## Core features
  30. ### Minimal core. Lightweight & extensible.
  31. One Rust router sits between your agents and every model provider. Extend it
  32. with providers, routing policies, tools, skills, and sub-agents without
  33. rebuilding your workflow around a new agent runtime.
  34. ### Interpretable decisions. Under your control.
  35. Routing policy lives in files you own. Routes are inspectable, changes are
  36. diffable, and a live policy changes only when you explicitly publish it.
  37. ### A customizable router. Adapt it to your workflow.
  38. Start with `bitrouter/auto`, then shape the models, rules, guardrails, and
  39. evaluation objective around your own loop. BitRouter learns from the outcomes
  40. you admit and proposes a new policy you can review, publish, or revert.
  41. ## Integrates with your agent stack
  42. Keep the clients and workflows you already use:
  43. - **Model APIs** — OpenAI Chat Completions and Responses, and Anthropic Messages, with cross-protocol routing. Metered Gemini uses Google’s OpenAI-compatible Chat endpoint.
  44. - **Coding agents** — built-in Codex and Claude support through native launchers, headless commands, and ACP adapters.
  45. - **Tools & skills** — manage upstream MCP configuration with `bro mcp` and existing local skill directories with `bro skills`. Install skills with `npx skills`; native tasks and supported ACP runs use explicitly selected skills. MCP content retains independent source permission and per-skill consent. See the [CLI reference](docs/CLI.md) for supported hosts, commands and delivery limits.
  46. ## Benchmarks
  47. On **Terminal-Bench 2.1**, BitRouter cut API cost by **40.9%** while achieving nearly the same reward as using `gpt-5.6-sol` alone.
  48. | Configuration | Reward | Cost / trial | Cost savings |
  49. | --- | ---: | ---: | ---: |
  50. | `gpt-5.6-sol` only | **81.56%** | $0.830 | — |
  51. | **BitRouter** | **81.25%** | **$0.490** | **40.9%** |
  52. | Random model mix | 76.50% | $0.553 | 33.4% |
  53. BitRouter dynamically routed between **GPT-5.6, Kimi K3, and DeepSeek V4 Flash**, retaining nearly all of GPT-5.6’s task performance while substantially reducing model cost.
  54. The random baseline used the same model mix, showing that the savings come from **routing decisions—not simply using cheaper models**.
  55. Results use the strict 80-task common-valid set and frozen API prices. This is a research benchmark, not an official Terminal-Bench submission.
  56. See the [full study and limitations](benchmarks/002-2026-09-07-tbench-v2.1-router-random-study.md) and the [`BitRouterAI/benchmarks`](https://huggingface.co/datasets/BitRouterAI/benchmarks) dataset for reproducible results.
  57. ## Install
  58. Official macOS distributions support Apple Silicon (`arm64`) only.
  59. ```bash
  60. # macOS (Apple Silicon) / Linux
  61. curl --proto '=https' --tlsv1.2 -LsSf https://github.com/bitrouter/bitrouter/releases/download/v1.0.0-alpha.33/bitrouter-installer.sh | sh
  62. # Homebrew
  63. brew install bitrouter/tap/bitrouter
  64. # Windows
  65. powershell -ExecutionPolicy Bypass -Command "irm https://github.com/bitrouter/bitrouter/releases/download/v1.0.0-alpha.33/bitrouter-installer.ps1 | iex"
  66. # npm
  67. npm install -g bitrouter
  68. # From source (Cargo)
  69. cargo install bitrouter
  70. ```
  71. These installers select the full product. Gateway-only release archives keep
  72. the same `bro` executable and run as an independent model service. See
  73. [distribution profiles](docs/DISTRIBUTION.md) for archive verification,
  74. configuration and profile-preserving updates.
  75. ## Quick start
  76. Run `bro` for line-based first-run setup. It ensures the background daemon is
  77. ready and returns to the shell; subsequent calls reuse that daemon. Native
  78. harness interfaces remain available through `bro claude`, `bro codex` and
  79. `bro launch <agent>`.
  80. `bro threads` manages native history, FIFO inputs, approvals and explicit
  81. recovery. `bro agents` lists current connections; its single-operation commands
  82. manage supervised ACP runs, settings, routes and native sessions. The existing
  83. ThreadService, Core and controller retain execution and permission ownership.
  84. `bro code`, `bro tui`, `bro chat` and `bro agents attach` have been removed.
  85. They return migration guidance and never open an interface or start work.
  86. ```bash
  87. bro # setup, then background daemon readiness
  88. bro agents # live instances; catalog: agents list
  89. bro run claude "summarize this repo" # one headless ACP turn
  90. bro run codex "inspect tests" --background
  91. bro agents pending <run-id> # inspect exact pending approvals
  92. bro threads list # authorized durable native Threads
  93. bro requests # settled requests and spend
  94. bro route <model> # explain model resolution
  95. ```
  96. The maintained Codex and Claude ACP adapters require Node.js 22+ and `npx`;
  97. native launchers use each harness's own interface and per-process overrides.
  98. See [`docs/CLI.md`](docs/CLI.md) for the complete command reference, session
  99. controls, flags, and config resolution.
  100. ## Workflow recipes
  101. Ready-made **policy specs** for common agentic workflows start in [`templates/auto-router/`](templates/auto-router): a predictive `bitrouter/auto` / `bitrouter/auto:cost` ladder using GPT-5.6 as the strong tier, Kimi K3 as balanced, and DeepSeek V4 Pro as economy. Treat it as a starting point and evaluate it against your own loop before publishing a live policy.
  102. ## Models & providers
  103. BitRouter routes to a *model*, not a provider. Each model below is served by many
  104. providers — its own lab, hyperscalers, gateways, and serverless clouds. BitRouter
  105. orders eligible routes by configured provider priority and can fall back on
  106. retryable failures. The bars are those routes: the more providers serve a model,
  107. the more room the router has to move. Current cost and latency sort options use
  108. the same deterministic priority order rather than live price or latency scoring.
  109. <p align="center">
  110. <picture>
  111. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/bitrouter/bitrouter/charts/dist/charts/registry-by-lab-dark.svg" />
  112. <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/bitrouter/bitrouter/charts/dist/charts/registry-by-lab.svg" />
  113. <img alt="BitRouter model catalog grouped by lab; bar length is the number of providers routing each model" src="https://raw.githubusercontent.com/bitrouter/bitrouter/charts/dist/charts/registry-by-lab.svg" />
  114. </picture>
  115. </p>
  116. **Bring your own key** to any of them, or use one **BitRouter Cloud** account with
  117. no keys at all. Frontier models from OpenAI, Anthropic, Google, and xAI also route
  118. over a subscription sign-in (Claude Pro/Max, GitHub Copilot, ChatGPT Codex)
  119. instead of a key.
  120. The chart is generated from [`dist/registry/`](dist/registry) on every catalog
  121. change — it is never hand-maintained, so it cannot drift from what the router
  122. actually resolves. Full catalog in [`registry/`](registry).
  123. ## Talk to founders
  124. **[Try BitRouter Cloud →](https://cloud.bitrouter.ai)** or reach out directly:
  125. Want a first-party provider integration, or building an open-source agent/harness? Email [kelsenliu@bitrouter.ai](mailto:kelsenliu@bitrouter.ai) or [book a meeting](https://cal.com/kelsenliu) — open-source builders get **up to 50% off** for you and your community.
  126. ## Development
  127. - [Development guide](docs/DEVELOPMENT.md) — documentation policy and engineering guide index
  128. - [`CONTRIBUTING.md`](CONTRIBUTING.md) — contribution workflow, issue reporting, and provider updates
  129. - [`CLAUDE.md`](CLAUDE.md) — guidance for AI coding agents working in this repository
  130. - [`skills/`](skills) — the `/bitrouter` Agent Skill (source of truth)
  131. ## Star History
  132. <a href="https://www.star-history.com/?type=date&repos=bitrouter%2Fbitrouter">
  133. <picture>
  134. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=bitrouter/bitrouter&type=date&theme=dark&legend=top-left&sealed_token=x3Lz0HqHPkyoGN8dh_Jdtkc-5lJ4iA_8eOmldMrXMyhVq7WCOxS03oBNGQXOxM962xv1AUhdyLKAtz6d1XK9ZSWUGHHd8HAWjEU44sXlwWT_I7iXPaTfizw7aDpxA-PrsxC3Jd5IN-SWladKBNoK2weKlIKVs9JQax5sbImPT9srpEeKzbYt_VsafBwd" />
  135. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=bitrouter/bitrouter&type=date&legend=top-left&sealed_token=x3Lz0HqHPkyoGN8dh_Jdtkc-5lJ4iA_8eOmldMrXMyhVq7WCOxS03oBNGQXOxM962xv1AUhdyLKAtz6d1XK9ZSWUGHHd8HAWjEU44sXlwWT_I7iXPaTfizw7aDpxA-PrsxC3Jd5IN-SWladKBNoK2weKlIKVs9JQax5sbImPT9srpEeKzbYt_VsafBwd" />
  136. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=bitrouter/bitrouter&type=date&legend=top-left&sealed_token=x3Lz0HqHPkyoGN8dh_Jdtkc-5lJ4iA_8eOmldMrXMyhVq7WCOxS03oBNGQXOxM962xv1AUhdyLKAtz6d1XK9ZSWUGHHd8HAWjEU44sXlwWT_I7iXPaTfizw7aDpxA-PrsxC3Jd5IN-SWladKBNoK2weKlIKVs9JQax5sbImPT9srpEeKzbYt_VsafBwd" />
  137. </picture>
  138. </a>
  139. ## License
  140. Licensed under the [Apache License 2.0](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.