token-coach

# Token Coach: Plan Token-Efficient Before You Build Interactive coaching for Claude Code or Codex architecture decisions. Analyzes your setup, identifies patterns (good and bad), and gives personalized advice with real numbers. **Use when**: Building something new, existing setup feels slow, designing multi-agent systems, or want a quick health check. --- ## Phase 0: Initialize 1. **Resolve runtime and measure.py path** (same as token-optimizer): ```bash RUNTIME="${TOKEN_OPTIMIZER_RUNTIME:-}" if [ -z "$RUNTIME" ]; then if [ -n "$CLAUDE_PLUGIN_ROOT" ] || [ -n "$CLAUDE_PLUGIN_DATA" ]; then RUNTIME="claude" elif [ -n "$OPENCODE" ] || [ -n "$OPENCODE_BIN" ] || [ -n "$OPENCODE_CONFIG_DIR" ] || [ -n "$OPENCODE_CONFIG" ]; then RUNTIME="opencode" elif [ -n "$CODEX_HOME" ]; then RUNTIME="codex" elif [ -d "$HOME/.config/opencode" ] && [ ! -d "$HOME/.codex" ]; then RUNTIME="opencode" elif [ -d "$HOME/.codex" ]; then RUNTIME="codex" else RUNTIME="claude" fi fi # Resolve measure.py to the NEWEST installed copy across channels so a stale # plugin-cache copy never shadows a fresh install (issue #57). find -L follows the # install.sh symlink under ~/.claude/skills; cd -P resolves it before reading each # copy's plugin.json for its version. find (not bare globs) never errors under zsh. MEASURE_PY=""; _best_ver="" while IFS= read -r _cand; do [ -f "$_cand" ] || continue _root="$(cd -P -- "$(dirname -- "$_cand")/../../.." 2>/dev/null && pwd)" _...