Skip to content
MCP server

Claudexor

Local control plane that routes coding work across Claude Code, Codex, Cursor and OpenCode

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Linux, CLI
Runs
Locally
Version
4.8.1
Listing updated
2 days ago

About Claudexor

Claudexor is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Claudexor sits above the coding agents you already pay for and keeps their work in a single history. Read-only questions resume the vendor's own session, write turns come back as inspectable patches, and every cost, quota and auth claim is recorded as a typed fact. Unknown cost is never shown as zero.

Its distinctive feature is quota-aware rotation. It reads live five-hour and seven-day windows per subscription for Claude Code and Codex, keeps credentials in isolated profiles, and, if you enable it, moves work only after a confirmed limit, not an ordinary network error. The next profile receives a bounded task packet, and native vendor sessions never cross a credential profile.

Beyond routing, the site describes races where independent candidates are reviewed across model families and an evidence-based winner is arbitrated, content-hashed task contracts, and gates that stop at protected paths. The README says everything runs locally with no telemetry, and it is the execution layer inside the Ouroboros agent. The macOS app needs macOS 26 or newer; the CLI runs on macOS and Linux with Node.js 24.15 or newer.

Install

Run in a terminal

claude mcp add claudexor -- npx -y claudexor

Add to claude_desktop_config.json

{
  "mcpServers": {
    "claudexor": {
      "command": "npx",
      "args": [
        "-y",
        "claudexor"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "claudexor": {
      "command": "npx",
      "args": [
        "-y",
        "claudexor"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "claudexor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "claudexor"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claudexor": {
      "command": "npx",
      "args": [
        "-y",
        "claudexor"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "claudexor": {
      "command": "npx",
      "args": [
        "-y",
        "claudexor"
      ]
    }
  }
}

What it does

Quota-aware rotation
Switches profiles after a confirmed subscription limit when you opt in.
Isolated profiles
Keeps separate Claude config directories and Codex homes with no shared credentials.
Cross-harness threads
Lets Claude Code, Codex, Cursor and OpenCode share one auditable project history.
Best-of-N races
Runs candidates in isolation, reviews across model families and picks a winner with evidence.
Inspectable patches
Write turns land as patches or file manifests rather than silent edits.
Local-first, no telemetry
Runs on your machine with files as the source of truth.

Good for

  • Keep coding when one subscription window is exhausted
  • Plan in one agent and implement in another
  • Have a second model family review a patch
  • Compare approaches before applying changes
  • Track real quota across several accounts

Pricing

Open source

MIT licensed; your own agent subscriptions or API keys still apply

Prices change. Check razzant.github.io before you buy.

Claudexor FAQ

Which accounts rotate automatically?

Multi-subscription quota telemetry and rotation are available for Claude Code and Codex; Cursor and OpenCode can join threads without rotation.

Is session history copied between agents?

No. Bounded continuation packets move between lanes, and native vendor-session resume never crosses a credential profile.

What does it need?

The macOS app requires macOS 26 or newer; the CLI needs Node.js 24.15 or newer on macOS or Linux, plus Git and a coding agent.

Does it collect data?

The site and README say there is no telemetry, and the web page makes no external requests.

How is it licensed?

The site lists MIT.

Is Claudexor free?

Yes. Claudexor is open source, so you can use and self-host it for free.

How do I add Claudexor to Claude Code?

Run this command in your terminal: claude mcp add claudexor -- npx -y claudexor

What are the best alternatives to Claudexor?

The closest alternatives to Claudexor are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Claudexor

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools