whatisgithub

What is claude-model-relay?

darasoba/claude-model-relay — explained in plain English

Analysis updated 2026-05-18

4JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A Claude Code skill that splits coding tasks across three AI models, one for planning, one for writing code, and one for reviewing, with automatic fallback if a model hits its usage limit.

Mindmap

mindmap
  root((Model Relay))
    What it does
      Plans with one model
      Implements with another
      Reviews with a third
    Tech stack
      Claude Code
      Fable 5
      Opus and Sonnet
    Use cases
      Route complex tasks to Opus
      Route simple tasks to Sonnet
      Automatic model fallback
    Audience
      Claude Code power users
    Install
      npx install command
      Claude Code plugin

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

Route architectural or security-sensitive code changes to a stronger model automatically

USE CASE 2

Keep routine, well-specified coding tasks on a cheaper model to save cost

USE CASE 3

Get an independent adversarial review of a code change before accepting it

USE CASE 4

Avoid silent quality loss when a model hits its usage limit mid-task

What is it built with?

Claude CodeFable 5OpusSonnet

How does it compare?

darasoba/claude-model-relayanil-matcha/open-poe-aiarata-ae/purupurupngtuber
Stars444
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-06-25
MaintenanceActive
Setup difficultyeasymoderatemoderate
Complexity2/53/53/5
Audiencedeveloperdevelopergeneral

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Works best with access to all the models in the fallback chains, such as Fable 5, Opus, and Sonnet.

Use freely for any purpose, including commercial use.

So what is it?

Claude Model Relay is a small set of skills and subagents for Claude Code that splits a coding task across three different AI models instead of using one model for everything. The idea is that the most expensive, most capable model is best spent on planning and on reviewing the finished work, while a mid-tier model can handle the actual writing of code once it has a clear plan to follow. The process runs in three stages. First, a read-only planner using Fable 5 looks at the real codebase, writes a step-by-step plan naming exact files and pieces of code, and classifies the task as either high complexity, meaning architectural changes, concurrency, security work, or an unclear root cause across many files, or standard complexity, meaning a contained and well-specified change. Second, an implementer stage carries out the plan, using Opus 4.8 for high complexity tasks and Sonnet 5 for standard ones, then runs the plan's own verification step and reports honestly if the actual work turned out to differ from the plan. Third, a separate read-only reviewer, again using Fable 5, independently re-checks the verification and the real code changes, then returns either an approval or a request to revise, capped at two revision rounds before the disagreement gets handed back to the person who asked for the change. Because each model has its own usage limits, the project also defines fallback chains, so if one model runs out of usage the task moves to a specified backup model instead of quietly failing, and the tool always reports out loud whenever this kind of fallback happens. Installation is a single command that copies one skill file and three subagent files into Claude Code's configuration folders, with alternative install paths through a Claude Code plugin or a manual git clone. The project is released under the MIT license, which allows free use, including commercial use.

Copy-paste prompts

Prompt 1
Install claude-model-relay and set it up as a Claude Code plugin
Prompt 2
Use the model-relay skill to add rate limiting to my API routes
Prompt 3
Explain how model-relay classifies a task as HIGH versus STANDARD complexity
Prompt 4
Add the model relay instructions to my CLAUDE.md so it runs automatically

Frequently asked questions

What is claude-model-relay?

A Claude Code skill that splits coding tasks across three AI models, one for planning, one for writing code, and one for reviewing, with automatic fallback if a model hits its usage limit.

What language is claude-model-relay written in?

Mainly JavaScript. The stack also includes Claude Code, Fable 5, Opus.

What license does claude-model-relay use?

Use freely for any purpose, including commercial use.

How hard is claude-model-relay to set up?

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

Who is claude-model-relay for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.