whatisgithub

What is subagent-model-routing?

buckeyes22/subagent-model-routing — explained in plain English

Analysis updated 2026-05-18

5PythonAudience · developerComplexity · 4/5Setup · moderate

In one sentence

A delegation tool that routes coding tasks between Claude Code, Codex, and other AI CLIs, verifying each handoff actually finished.

Mindmap

mindmap
  root((subagent-model-routing))
    What it does
      Delegates tasks between AI CLIs
      Verifies delegated work finished
      Logs outcomes in a ledger
    Tech stack
      Python
      Bash shims
      Claude Code and Codex
    Use cases
      Route tasks to the right model
      Catch silent delegation failures
      Learn best model per task type
    Audience
      Developers with multiple AI subscriptions
      Multi-agent tool builders

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

Delegate a coding task from Claude Code to another installed AI CLI like Codex or Grok.

USE CASE 2

Catch silent delegation failures before a broken response is used as a real result.

USE CASE 3

Track which AI model performs best for which kind of task using a routing ledger.

USE CASE 4

Route tasks across multiple AI coding subscriptions without manual copy-pasting.

What is it built with?

PythonBashClaude CodeCodex

How does it compare?

buckeyes22/subagent-model-routing1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity4/53/52/5
Audiencedeveloperops devopsgeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python 3.11+, GNU timeout, and separately installed and authenticated provider CLIs for each model you route to.

So what is it?

subagent-model-routing is a tool for people who pay for more than one AI coding assistant, such as Claude Code, Codex, Grok, Kimi, or GLM, and want to delegate a task from one to another without manually copying a prompt into a second terminal and pasting the answer back. It adds a set of small command line shims, one for each supported model family, that send a prompt to another AI coding tool, wait for it to finish, and hand the result back with a clear success or failure signal. Alongside the shims, the project includes a routing skill that decides when a task should be delegated and which model is the right fit for it, plus guardrails that catch cases where a delegated task silently fails, such as missing output or an unexpected error code, so a broken response never gets mistaken for a working one. It also keeps a ledger recording how long each delegation took, whether it succeeded, and other details, so future routing decisions can be based on what has actually worked well before rather than guesswork. The project explains that it is not the same as an API request router like the tools that pick which backend answers a single completion request. Instead, it hands off entire chunks of agentic work, complete with file editing and command execution, to a full separate coding assistant, and then checks that the work genuinely finished. It is meant to sit alongside tools like OpenCode rather than replace them, adding verification and a decision-making layer on top. Installing it requires Python 3.11 or newer, the GNU timeout command, and already having the other AI coding CLIs you want to route to installed and logged in separately. Setup is handled through a bootstrap installer script or a manual clone-and-install process, with separate installation steps for Claude Code, Codex, and other supported clients. The full readme is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me run the bootstrap installer to set up subagent-model-routing for Claude Code.
Prompt 2
Explain how the SHIM-DONE sentinel confirms a delegated task actually finished.
Prompt 3
Walk me through installing the Claude Code plugin package for this project.
Prompt 4
Show me how the routing ledger records dispatch outcomes for future decisions.

Frequently asked questions

What is subagent-model-routing?

A delegation tool that routes coding tasks between Claude Code, Codex, and other AI CLIs, verifying each handoff actually finished.

What language is subagent-model-routing written in?

Mainly Python. The stack also includes Python, Bash, Claude Code.

How hard is subagent-model-routing to set up?

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

Who is subagent-model-routing for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.