mcpField
E
ecomode

ecomode

github.com/yeachan-heoAgent workflows40.4k37 installsUpdated 2d ago
Repository

About ecomode

Ecomode is a model-routing modifier for Oh My ClaudeCode that favors lower-cost model tiers and escalates when needed. It can combine with execution modes but does not provide persistence or parallel execution itself.

Key features

  1. 01Prefers lower model tiers
  2. 02Escalates when a lower tier fails
  3. 03Combines with execution modes
  4. 04Uses tier-specific agent selection
  5. 05Tracks state and supports disabling

Use cases

  1. 01Routing routine tasks to lower tiers
  2. 02Combining cost-aware routing with Ralph
  3. 03Running parallel work with Ultrawork
  4. 04Disabling the modifier through configuration

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/yeachan-heo/oh-my-claudecode --skill ecomode

After installing, type/ecomodein Claude Code to confirm it loaded.

Details

From the project README

Ecomode Skill

Token-efficient model routing. This is a MODIFIER, not a standalone execution mode.

What Ecomode Does

Overrides default model selection to prefer cheaper tiers:

Default TierEcomode Override
HIGH (opus)MEDIUM (sonnet), HIGH only if essential
MEDIUM (sonnet)LOW (haiku) first, MEDIUM if fails
LOW (haiku)LOW (haiku) - no change

What Ecomode Does NOT Do

  • Persistence: Use ralph for "don't stop until done"
  • Parallel Execution: Use ultrawork for parallel agents
  • Delegation Enforcement: Always active via core orchestration

Combining Ecomode with Other Modes

Ecomode is a modifier that combines with execution modes:

CombinationEffect
eco ralphRalph loop with cheaper agents
eco ultraworkParallel execution with cheaper agents
eco autopilotFull autonomous with cost optimization

Ecomode Routing Rules

ALWAYS prefer lower tiers. Only escalate when task genuinely requires it.

DecisionRule
DEFAULTStart with LOW tier (Haiku) for most tasks
UPGRADEEscalate to MEDIUM (Sonnet) when LOW tier fails or task requires multi-file reasoning
AVOIDHIGH tier (Opus) - only for planning/critique if essential

Agent Selection in Ecomode

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
Task(subagent_type="oh-my-claudecode:executor-low", model="haiku", prompt="...")
Task(subagent_type="oh-my-claudecode:explore", model="haiku", prompt="...")
Task(subagent_type="oh-my-claudecode:architect-low", model="haiku", prompt="...")

// FALLBACK - Only if LOW fails
Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="...")
Task(subagent_type="oh-my-claudecode:architect-medium", model="sonnet", prompt="...")

// AVOID - Only for planning/critique if essential
Task(subagent_type="oh-my-claudecode:planner", model="opus", prompt="...")

Delegation Enforcement

Ecomode maintains all delegation rules from core protocol with cost-optimized routing:

ActionDelegate ToModel
Code changesexecutor-low / executorhaiku / sonnet
Analysisarchitect-lowhaiku
Searchexplorehaiku
Documentationwriterhaiku
Background Execution

Long-running commands (install, build, test) run in background. Maximum 20 concurrent.

Token Savings Tips

  1. Batch similar tasks to one agent instead of spawning many
  2. Use explore (haiku) for file discovery, not architect
  3. Prefer executor-low for simple changes - only upgrade if it fails
  4. Use writer (haiku) for all documentation tasks
  5. Avoid opus agents unless the task genuinely requires deep reasoning

Disabling Ecomode

Ecomode can be completely disabled via config. When disabled, all ecomode keywords are ignored.

Set in ~/.claude/.omc-config.json:

{
  "ecomode": {
    "enabled": false
  }
}

State Management

Ecomode state is tracked in .omc/state/ecomode-state.json.

When work is complete, run /oh-my-claudecode:cancel for clean state cleanup.

Comments

Markdown supported