Token-efficient model routing modifier
Token-efficient model routing. This is a MODIFIER, not a standalone execution mode.
Overrides default model selection to prefer cheaper tiers:
| Default Tier | Ecomode Override |
|---|---|
| THOROUGH | STANDARD, THOROUGH only if essential |
| STANDARD | LOW first, STANDARD if needed |
| LOW | LOW - no change |
ralph for "don't stop until done"ultrawork for parallel agentsEcomode is a modifier that combines with execution modes:
| Combination | Effect |
|---|---|
eco ralph | Ralph loop with cheaper agents |
eco ultrawork | Parallel execution with cheaper agents |
eco autopilot | Full autonomous with cost optimization |
ALWAYS prefer lower tiers. Only escalate when task genuinely requires it.
| Decision | Rule |
|---|---|
| DEFAULT | Start with LOW tier for most tasks |
| UPGRADE | Escalate to STANDARD when LOW tier fails or task requires multi-file reasoning |
| AVOID | THOROUGH tier - only for planning/critique if essential |
FIRST ACTION: Before delegating any work, read the agent reference file:
Read file: docs/shared/agent-tiers.md
This provides the complete agent tier matrix, MCP tool assignments, and selection guidance.
Ecomode preference order:
// PREFERRED - Use for most tasks
delegate(role="executor", tier="LOW", task="...")
delegate(role="explore", tier="LOW", task="...")
delegate(role="architect", tier="LOW", task="...")
// FALLBACK - Only if LOW fails
delegate(role="executor", tier="STANDARD", task="...")
delegate(role="architect", tier="STANDARD", task="...")
// AVOID - Only for planning/critique if essential
delegate(role="planner", tier="THOROUGH", task="...")
Ecomode maintains all delegation rules from core protocol with cost-optimized routing:
| Action | Delegate To | Model |
|---|---|---|
| Code changes | executor | LOW / STANDARD |
| Analysis | architect | LOW |
| Search | explore | LOW |
| Documentation | writer | LOW |
Long-running commands (install, build, test) run in background. Maximum 20 concurrent.
Ecomode can be completely disabled via config. When disabled, all ecomode keywords are ignored.
Set in ~/.codex/.omx-config.json:
{
"ecomode": {
"enabled": false
}
}
Use omx_state MCP tools for ecomode lifecycle state.
state_write({mode: "ecomode", active: true})state_write({mode: "ecomode", active: false})$cancel (which should call state_clear(mode="ecomode"))