mux-config

/mux-config command

View or modify the routing configuration stored in .agent-mux/config.yaml.

Usage

• /mux-config -- show current configuration
• /mux-config set <key> <value> -- update a specific setting
• /mux-config reset -- reset configuration to tier defaults

Implementation Steps

Step 1: Parse the subcommand

Look at the user's input after /mux-config:

• No arguments → show config
• set <key> <value> → update setting
• reset → reset to defaults

Step 2: Locate the config file

The config file is at .agent-mux/config.yaml relative to the project root.

# Find the project root (where .agent-mux/ lives or should live)
PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
CONFIG_DIR="$PROJECT_ROOT/.agent-mux"
CONFIG_FILE="$CONFIG_DIR/config.yaml"

---

Show current config (/mux-config)

1. Read .agent-mux/config.yaml from the project root using the Read tool.
2. If the file does not exist, inform the user and show default configuration for the Budget tier.
3. Parse the YAML content and display it in this exact format:

[agent-mux] ═══ Configuration ═══
  Config file: .agent-mux/config.yaml

  Tier: {tier}

  Routing:
    engine:   {local|hybrid}
    bias:     {codex|balanced|claude|adaptive}
    split:    Claude {claude_pct}% / Codex {codex_pct}%

  Escalation:
    enabled:     {true|false}
    strategy:    {fix|fix_then_redo|full}
    max_retries: {n}

  Features:
    batch_mode:          {on|off}
    conservation_mode:   {on|off}
    parallel_dispatch:   {on|off}
    task_decomposition:  {on|off}

  Budget Warnings: {thresholds}

  Deny List:
    {deny_list_entries, one per line}
═══════════════════════════════

For features, check these YAML keys:

• batch_mode.enabled → batch_mode
• conservation.enabled → conservation_mode
• parallel_dispatch.enabled → parallel_dispatch (default: off unless Standard+ tier)
• task_decomposition.enabled → task_decomposition (default: off unless Premium+ tier)