interop-router

Automatic Routing to External AI CLIs

Auto-trigger: This skill evaluates tasks automatically and decides whether to delegate to an external CLI. No manual invocation needed.

Auto-Trigger Conditions

Automatically evaluate when detecting:

• Large refactoring (10+ files affected)
• Batch file changes
• Template generation tasks
• Multi-model cross-validation needs

Decision Scoring

Calculate delegation score using 3 factors:

| Factor | Range | Description | |--------|-------|-------------| | Benefit | 0.0 - 0.6 | Can external CLI produce faster/more reliable results? | | Cost | -0.3 - 0.0 | Overhead of wrapping, normalizing, reviewing | | Risk | -0.3 - 0.0 | Permission/write/secret leakage risks |

Threshold: Score >= 0.15 with auto-interop enabled -> auto-execute delegation

Routing Targets

| Task Type | Target CLI | Reason | |-----------|------------|--------| | Large codebase exploration | Gemini | 1M token context | | Batch implementation | Codex | Fast bulk generation | | Complex architecture analysis | Gemini | Deep reasoning | | Template generation | Codex | Efficient structured output |

Process

1. Check CLI Availability

bash "$CLAUDE_PROJECT_DIR/skills/interop-router/scripts/check_cli_available.sh" --json

2. Score the Decision

python3 "$CLAUDE_PROJECT_DIR/skills/interop-router/scripts/score_decision.py" \
  --task "task description" \
  --files 15 \
  --complexity high \
  --json

3. Wrap Context (if delegating)

python3 "$CLAUDE_PROJECT_DIR/skills/interop-router/scripts/wrap_context.py" \
  --files src/*.py \
  --diff \
  --output /tmp/context.md

4. Execute with External CLI

# Codex
codex "Your task description" < /tmp/context.md

# Gemini
gemini "Your task description" -f /tmp/context.md

Safety Constraints

• Default read-only mode
• Automatic secret filtering (API keys, passwords, tokens, connection strings)
• All results must be reviewed before landing
• Sensitive files (.env, credentials, private keys) are always skipped

Configuration

Enable auto-interop:

# Project-level (takes precedence)
mkdir -p .claude/flags
echo '{"enabled": true}' > .claude/flags/auto-interop.json

# User-level
mkdir -p ~/.claude/flags
echo '{"enabled": true}' > ~/.claude/flags/auto-interop.json