github-router weekly downloads statistics

github-router

Use your GitHub Copilot subscription to power Claude Code, Codex CLI, or any OpenAI/Anthropic-compatible tool.

github-router is a local reverse proxy that translates standard API formats to GitHub Copilot's backend. One command to start, copy-paste configs for your tools.

[!WARNING] Unofficial. Not supported by GitHub. May break. Use responsibly. Review the GitHub Copilot Terms and Acceptable Use Policies.

Quick Start

# 1. Authenticate (one-time)
bunx github-router@latest auth

# 2. Start the proxy
bunx github-router@latest start

The server runs at http://localhost:8787. Now pick your tool below.

Bun is the default runtime for developing and running github-router (bunx, bun install, bun test). Plain Node.js 24/26 + npm stay supported (see the node-compat CI lane) — every bunx command below has an npx equivalent.

---

Use with Claude Code

Option A: One-shot subcommand (recommended)

bunx github-router@latest claude

Boots the proxy on a random port and spawns Claude Code wired to it. Sets ANTHROPIC_MODEL=claude-opus-4-8 (Anthropic's dashed slug — Claude Code's /model UI displays this as menu entry "Opus 4.8 (1M context)"). The proxy translates to Copilot's claude-opus-4.8 at request time (single base slug; the catalog entry's max_context_window_tokens already advertises 1M context — no -1m sibling needed for 4.8). Major.minor fallback chain: claude-opus-4-7 → claude-opus-4-6 → claude-opus-4-5. Override with -m:

bunx github-router@latest claude -m claude-opus-4-8

The launcher sanitizes parent-env auth keys and sets CLAUDE_CONFIG_DIR=$HOME/.claude so the spawned claude ignores any persisted Console OAuth credential without requiring claude /logout. Settings, MCP servers, hooks, and CLAUDE.md auto-discovery still load from ~/.claude as normal.

Option B: Interactive launch-command generator

bunx github-router@latest start --claude-code

Select your models, a launch command gets copied to your clipboard. Paste it in a new terminal.

Option C: Copy-paste config

Create .claude/settings.json in your project:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:8787",
    "ANTHROPIC_API_KEY": "dummy",
    "ANTHROPIC_AUTH_TOKEN": "dummy",
    "ANTHROPIC_MODEL": "gpt-4.1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-4.1",
    "ANTHROPIC_SMALL_FAST_MODEL": "gpt-4.1-mini",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-4.1-mini",
    "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "deny": ["WebSearch"]
  }
}

Then run claude as normal.

Peer-MCP review subagents

github-router claude auto-wires four peer-model adversarial reviewers plus a coordinator into the spawned Claude Code session. No setup, no prior MCP config, no .claude/agents/ files needed — they appear as Task subagent_type options the session can delegate to. Opt out with --no-codex-mcp.

Each persona is exposed both as a Claude Code subagent (callable via the Task tool) AND as an MCP tool at mcp__peers__<name>. Personas are stateless: each invocation runs a fresh request against its model with a baked persona prompt — they have no access to your scrollback or project memory, so the lead must paste the artifact into the brief.

Subagent	Model	Endpoint	Effort tiers (default)
codex-critic	gpt-5.6-sol	/v1/responses	low | medium | high | xhigh (xhigh)
codex-reviewer	gpt-5.3-codex	/v1/responses	low | medium | high | xhigh (xhigh)
gemini-reviewer	gemini-3.1-pro-preview	/v1/chat/completions	low | medium | high (high)
opus-critic	claude-opus-4-6	/v1/messages	low | medium | high (high)
gemini-critic	gemini-3.1-pro-preview	/v1/chat/completions	low | medium | high (high)
peer-review-coordinator	(meta)	—	—

peer-review-coordinator is a subagent (not an MCP tool) that fans out to the right combination of the critics in parallel based on artifact type — plan, diff, single file, or long-context — and aggregates findings.

Effort tiers are exposed via the MCP tool's effort argument; subagents pass it through. xhigh routinely runs 60–90s; the proxy responds to tools/call requests with SSE-streamed responses (per MCP 2025-06-18 Streamable HTTP transport spec) so the connection stays open past the standard ~60s MCP per-tool-call ceiling and long calls complete transparently with no user setup.

gemini-critic and gemini-reviewer both register only when gemini-3.1-pro-preview (or another gemini-3.x-pro model) is present in your Copilot model catalog — gemini-critic is the architecture-level critic, gemini-reviewer the line-level second-lab code reviewer on the same model at its highest reasoning tier. If absent, both personas are silently dropped from the MCP tools/list and the subagent set, and peer-review-coordinator skips them in routing decisions.

Code search (mcp__search__code)…