codex-auto-model-router

Routes Codex tasks to GPT-5.6 Sol, Terra, or Luna models with matched reasoning effort.

49|3|Updated Jul 14, 2026
One-click install
npx skills add https://github.com/orange-the-weak/codex-auto-model-router --skill codex-auto-model-router-orange-the-weak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-auto-model-router
Source: https://github.com/orange-the-weak/codex-auto-model-router
Command: npx skills add https://github.com/orange-the-weak/codex-auto-model-router --skill codex-auto-model-router-orange-the-weak

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Choosing the right GPT-5.6 model and reasoning effort for every Codex task is repetitive manual work, and picking wrong wastes either quality or latency. This Skill automates that decision with a fail-open, benefit-gated router that recommends a route once and only spawns a model-specific subagent when the benefit clearly exceeds startup overhead. ## Core Features & Use Cases - Automatic model routing: Classifies each task as mechanical, ordinary, or complex and recommends Luna, Terra, or Sol with low-through-max reasoning effort based on benchmark-calibrated lanes. - Benefit-gated subagents: Automatically creates or reuses a bounded leaf agent running the recommended model only when route benefit clears measured startup and aggregation cost; otherwise work stays local. - Low-overhead tool concurrency: Runs independent safe tool and process calls concurrently in the coordinator without creating child agents. - Project-scoped exit: Disable, restore, or check the Skill per project via managed entries in the project's .codex/config.toml. - Use Case: A developer asks Codex to refactor a module; the router classifies it as bounded complex work, recommends Sol/medium, and either executes locally or delegates to a Sol leaf agent, showing a one-line routing notice in the user's language. ## Quick Start Ask Codex to install the codex-auto-model-router Skill from its GitHub repository, restart Codex, then make any code change request and the router will recommend and apply a model route automatically.

Frequently Asked Questions about codex-auto-model-router

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically choose a GPT-5.6 model in Codex?

Install the codex-auto-model-router Skill and it classifies each task as mechanical, ordinary, or complex, then recommends Luna, Terra, or Sol with an appropriate reasoning effort. Execution stays local unless switching models clearly outweighs subagent startup cost.

How do I disable a Codex Skill for one project only?

Run router_lite.py project-disable --repository . from the Skill's scripts directory. It adds one managed [[skills.config]] entry to the project's .codex/config.toml without touching global settings, and project-enable restores it.

When does the router create subagents in Codex?

Subagents are created automatically only when the recommended model differs and the route-fit, quality, or latency benefit clearly exceeds bounded startup and aggregation overhead. Users can opt out per command with --no-subagents.

Does the router ever select GPT-5.6 Ultra or GPT-5.5 automatically?

No. Ultra is never auto-selected and requires an explicit user request, which disables Router-managed parallelism. GPT-5.5 is used only after the entire GPT-5.6 family is proven unavailable, and that fallback is disclosed once.

What happens if routing or the ledger fails during a task?

The default path is fail-open: router, ledger, or executor startup failures never block ordinary project work. Ledger errors are treated as non-blocking warnings and are normally omitted from the user-facing response.