gitwtfhub

wtf is claude-model-relay?

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

Analysis updated 2026-05-18

4JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

REASON 4

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

What's in the stack?

Claude CodeFable 5OpusSonnet

How it stacks up

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 spin it up?

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.

Wtf does this do

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.

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.