whatisgithub

What is arbitrage?

blader/arbitrage — explained in plain English

Analysis updated 2026-05-18

86Audience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A Claude Code skill that saves premium model tokens by dispatching all code writing to Codex while keeping planning and review for itself.

Mindmap

mindmap
  root((Arbitrage))
    What it does
      Splits planning from code writing
      Dispatches implementation to Codex
      Reviews and commits the result
    Tech stack
      Claude Code skill
      Codex CLI
      Git
    Use cases
      Save premium AI tokens on coding tasks
      Use idle Codex quota productively
      Validate frontend UI against design intent
    Audience
      Developers using Claude Code
      Teams paying for multiple AI subscriptions

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Reduce premium AI token spend by offloading code writing to a cheaper agent.

USE CASE 2

Keep a premium model focused on specs, review, and judgment calls instead of typing code.

USE CASE 3

Run a visual validation loop where the premium model screenshots and judges frontend work.

USE CASE 4

Fall back to the premium model writing code directly if the cheaper agent fails twice.

What is it built with?

Claude CodeCodex CLIGit

How does it compare?

blader/arbitrageenergypantry/agent-browser-runtimejohunsang/semble_rs
Stars868686
LanguageJavaScriptRust
Setup difficultyeasyhardeasy
Complexity2/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires the codex CLI (codex exec) available on your PATH in addition to Claude Code.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Arbitrage is a skill file for Claude Code, the AI coding assistant from Anthropic. It addresses a cost problem: when you use a top-tier AI model to write code, you spend expensive tokens on work that a cheaper model could handle just as well. This skill teaches the expensive model to be more selective about what it does itself. The idea is a split. The premium model keeps the work that actually needs its judgment: planning, writing specifications, reviewing what was built, validating frontend visuals, and deciding whether the result is acceptable. It hands off the actual code writing to Codex, OpenAI's coding agent, which runs in the background on a separate quota. For many users, their Codex subscription sits mostly unused, making this a way to get more out of what they are already paying for. The workflow follows a pattern. Before any code is written, the premium model drafts a spec: what the goal is, the constraints, what test must pass, and what should not be touched. It then dispatches implementation to Codex and continues planning or reviewing in parallel rather than waiting. When Codex finishes, the diff comes back, the premium model reviews it, and commits are made from the main session. Codex never interacts with git directly. For frontend work, the skill adds a visual loop. Codex writes the UI, the premium model takes a screenshot, judges it against the original design intent, and sends Codex back with specific corrective feedback until the result looks right. There is a built-in escape hatch. If Codex fails twice in a row even after corrective feedback, the premium model steps in and writes the code itself, salvaging whatever it can from Codex's incomplete attempt. Installation is a single git clone into the appropriate skills directory. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Install the arbitrage skill into my Claude Code skills directory using git clone.
Prompt 2
Explain how the arbitrage skill splits work between Claude Code and Codex.
Prompt 3
Walk me through what happens when Codex fails the acceptance criteria twice under this skill.
Prompt 4
Show me how the visual validation loop works for frontend changes with this skill.

Frequently asked questions

What is arbitrage?

A Claude Code skill that saves premium model tokens by dispatching all code writing to Codex while keeping planning and review for itself.

What license does arbitrage use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is arbitrage to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is arbitrage for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.