explaingit

dangerousyams/muxer

Analysis updated 2026-05-18

2ShellAudience · developerComplexity · 3/5Setup · moderate

TLDR

A Claude Code plugin that routes coding tasks to different AI models by cost and capability, keeping an expensive orchestrator in a lean planning loop while cheaper models do the execution work.

Mindmap

mindmap
  root((Muxer))
    What it does
      Route tasks by model tier
      Keep orchestrator lean
      Cost reporting
    Agents
      Scout on Haiku
      Builder on Opus
      Oracle on Fable
      Codex and Gemini external
    How it works
      Agent frontmatter model pin
      Session policy hook
      PreToolUse guard hook
    Use cases
      Reduce Claude Code costs
      Fable-orchestrated sessions
      Multi-model coding workflow
Click or tap to explore — scroll the page freely

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

Run a Claude Code session where planning happens on Fable but file reads and boilerplate writing use cheaper models.

USE CASE 2

Get a cost report after each coding session showing actual spend versus what the same work would have cost on one model.

USE CASE 3

Dispatch coding tasks to OpenAI Codex or Google Gemini from inside a Claude Code session, using zero Anthropic tokens.

What is it built with?

ShellClaude CodeClaude API

How does it compare?

dangerousyams/muxerchrisor-dev/claude-autosynckyr0/ornith-35b-fp8-e4m3-mtp
Stars222
LanguageShellShellShell
Setup difficultymoderatemoderatehard
Complexity3/53/55/5
Audiencedeveloperdeveloperresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Claude Code with plugin support, external Codex and Gemini delegates need their respective CLIs installed and signed in separately.

License not stated in the README.

In plain English

Muxer is a plugin for Claude Code that routes different parts of a coding session to different AI models based on what the work actually requires. The idea is that an expensive model like Fable handles planning and judgment while cheaper models handle the execution: file exploration on Haiku, documentation and boilerplate on Sonnet, implementation on Opus. The orchestrating model stays in a lean main loop, only reading summaries and plans rather than raw files, which keeps its token cost low even at premium rates. The routing happens in three places. Each agent definition file includes a hard model assignment in its header, so a scout agent always runs on Haiku and a builder always runs on Opus regardless of what the main session uses. A startup hook injects a short policy into every session telling the orchestrator to delegate rather than do everything itself. A third guard hook catches Claude Code's built-in subagents (like file exploration) before they inherit the session's expensive model, and pins them to Opus instead. The plugin includes seven named agents: a scout for read-only exploration, a writer for low-risk edits and copy, a builder for implementation, a reviewer for adversarial verification, an oracle that escalates to Fable for hard decisions, and two external delegates that dispatch work to OpenAI Codex and Google Gemini through their command-line tools, consuming zero Anthropic tokens. The quality rules are deliberately conservative: never hand a whole big task to a cheap model at once, always build one example at a verified tier before fanning out, and never use a cheaper model to review work that a more expensive model built. A task that fails review twice at one tier gets redone at the tier above. After each session, a cost report compares actual spending against what the same work would have cost if run entirely on the main model. The comparison uses API list prices with cache-adjustment. The license is not mentioned in the README.

Copy-paste prompts

Prompt 1
I want to set up Muxer in my Claude Code environment. Walk me through cloning the repo, installing the plugin, and verifying the agents are working correctly.
Prompt 2
Explain how Muxer decides which model to use for a given task. What triggers the scout versus the builder versus the oracle?
Prompt 3
How does the Muxer cost report work? What does it measure and what does the output line mean?
Prompt 4
I want to add a new agent to Muxer that runs on Sonnet and handles database schema design tasks. What files do I need to create and what format should they follow?

Frequently asked questions

What is muxer?

A Claude Code plugin that routes coding tasks to different AI models by cost and capability, keeping an expensive orchestrator in a lean planning loop while cheaper models do the execution work.

What language is muxer written in?

Mainly Shell. The stack also includes Shell, Claude Code, Claude API.

What license does muxer use?

License not stated in the README.

How hard is muxer to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is muxer for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub dangerousyams on gitmyhub

Verify against the repo before relying on details.