whatisgithub

What is modelrouter?

scylla23/modelrouter — explained in plain English

Analysis updated 2026-05-18

0HTMLAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A Claude Code plugin that routes each task to the cheapest capable Claude model to stretch a usage plan further.

Mindmap

mindmap
  root((ModelRouter))
    What it does
      Routes tasks by cost
      Announces every choice
      Learns from corrections
    Tech stack
      Node.js scripts
      Claude Code hooks
      Claude Code skills
    Use cases
      Stretch Max plan quota
      Redo task on bigger model
      Audit mode trial run
    Audience
      Claude Code users
      Cost conscious developers
    Setup
      One marketplace command
      No API keys needed
      No configuration required

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

Automatically route coding tasks to the cheapest Claude model tier that can handle them.

USE CASE 2

Re-run a task on a bigger model with one command when the cheap tier gets it wrong.

USE CASE 3

Try a zero-risk audit mode that logs routing decisions without actually delegating.

What is it built with?

Node.jsClaude Code HooksClaude Code Skills

How does it compare?

scylla23/modelrouter100/rutgers-pbl-dining-2015a15n/a15n_old
Stars0
LanguageHTMLHTMLHTML
Last pushed2015-12-012016-06-18
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/51/51/5
Audiencedevelopergeneralgeneral

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Installs as a Claude Code plugin with a single marketplace command, no API keys or config needed.

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

So what is it?

ModelRouter is a plugin for Claude Code, the command line coding assistant from Anthropic, that automatically sends each task to the cheapest Claude model that can handle it well, rather than always using the most expensive one. The goal is to help people on a fixed usage plan, like Anthropic's Max plan, make their weekly quota last longer without having to think about which model to pick for each request. Every time the router hands a task to a worker model such as Haiku, Sonnet, Opus, or a model called Fable, it prints a short line explaining which model was chosen and why, so the choice is never hidden. If a routed task turns out wrong for its assigned tier, a single command called router redo reruns that same task on a more capable model one level up, and the tool remembers that correction so it makes a better choice next time in similar situations. Over time it builds up a set of personal rules, stored as a plain text file on your own computer, describing which kinds of tasks you have needed escalated in the past. Technically, the plugin works using three built in Claude Code extension points: hooks, skills, and agents. A hook injects routing instructions before each task, another hook checks new delegations against your learned rules and can bump a task to a bigger model if needed, and a skill can temporarily raise the model for a single complex turn before reverting back afterward. There is no proxy server sitting between you and Anthropic, no API key required beyond your normal Claude Code login, and nothing intercepts network traffic. Everything the tool learns and logs stays in plain markdown and JSON files on your own machine, in a folder called dot-router, and nothing is sent elsewhere. Installation is a single command through the Claude Code plugin marketplace, with no extra configuration needed. The project also ships a watch-only audit mode that logs what it would have routed without actually changing anything, useful for trying it out with no risk. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me install ModelRouter using the Claude plugin marketplace command.
Prompt 2
Explain how ModelRouter decides which model tier to route a task to.
Prompt 3
Walk me through using /router:audit on to try ModelRouter without any risk.
Prompt 4
Help me interpret the output of /router:stats after a week of use.

Frequently asked questions

What is modelrouter?

A Claude Code plugin that routes each task to the cheapest capable Claude model to stretch a usage plan further.

What language is modelrouter written in?

Mainly HTML. The stack also includes Node.js, Claude Code Hooks, Claude Code Skills.

What license does modelrouter use?

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

How hard is modelrouter to set up?

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

Who is modelrouter for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.