@dst-justin/relay 2.1.2 → 2.2.0

package/README.md

@@ -229,6 +229,15 @@ Sessions live in `~/.claude/projects/` and are shared across all accounts — af
 - `relay update` now detects original install method: uses `npm install -g` for npm installs, `git pull` for git clones, and direct GitHub download for bare script copies
 - `npm install -g` post-install script automatically patches `~/.bashrc`, `~/.zshrc`, `~/.profile`, and fish `config.fish` if the npm bin dir is missing from PATH
 
+### v2.1.3 — 2026-06-24
+- `relay autoswitch` with no subcommand: auto-routes to config wizard (first time) or status panel (already configured)
+- Autoswitch status and log panels now show version info and update notice at the bottom
+- Status panel shows available commands inline
+
+### v2.1.2 — 2026-06-24
+- Improve autoswitch config wizard: 3-step flow with numbered account list, space-separated number input for order, visual chain preview (`work → personal → (cycle)`), and summary after save
+- `relay update` now writes the live-fetched version to cache immediately, so display commands reflect the latest version without waiting 24h
+
 ### v2.1.0 — 2026-06-24
 - Upgraded GitHub Actions workflow to `actions/checkout@v6` and `actions/setup-node@v6` (Node 24 runtime, removes Node 20 deprecation warning)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dst-justin/relay",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "Multi-account switcher for Claude Code — instant credential swap across macOS, Linux, and Windows",
   "bin": {
     "relay": "./relay.js"

package/relay

@@ -226,8 +226,9 @@ def save_cache(c):
     except Exception:
         pass
 
-def fetch(name):
+def fetch(name, _retried=False):
     cred_path = os.path.join(creds_dir, name + '.json')
+    was_refreshed = False
     try:
         d = json.load(open(cred_path))
         oauth = d.get('claudeAiOauth') or {}
@@ -235,16 +236,21 @@ def fetch(name):
         if not tok:
             return name, None
 
-        # Short-circuit: token is locally known to be expired
         expires_at_ms = oauth.get('expiresAt', 0)
         now_ms = datetime.datetime.now(datetime.timezone.utc).timestamp() * 1000
-        if expires_at_ms and now_ms > expires_at_ms:
-            return name, 'expired'
+        # Pre-emptive: refresh 5 minutes before expiry (300000ms)
+        if expires_at_ms and now_ms > expires_at_ms - 300000:
+            new_tok = try_refresh(name, cred_path)
+            if new_tok:
+                tok = new_tok
+                was_refreshed = True
+            elif now_ms > expires_at_ms:
+                return name, 'expired'
+            # else: pre-emptive window, refresh failed, token still valid — fall through
 
-        # Check cache
         c = load_cache()
         entry = c.get(name)
-        if entry and now_ms / 1000 - entry.get('ts', 0) < CACHE_TTL:
+        if entry and now_ms / 1000 - entry.get('ts', 0) < CACHE_TTL and not was_refreshed:
             return name, entry.get('data')
 
         req = urllib.request.Request(
@@ -256,7 +262,10 @@ def fetch(name):
         save_cache(c)
         return name, data
     except urllib.error.HTTPError as e:
-        if e.code == 401:
+        if e.code == 401 and not _retried:
+            new_tok = try_refresh(name, cred_path)
+            if new_tok:
+                return fetch(name, _retried=True)
             return name, 'expired'
         return name, None
     except Exception:
@@ -399,7 +408,7 @@ cmd_status() {
     warn "Recorded account '${current}' no longer exists"
   else
     "${PY}" - "$(account_creds "${current}")" "${current}" "$(get_meta_email "${current}")" <<'EOF'
-import json, sys, datetime, urllib.request
+import json, sys, datetime, urllib.request, urllib.parse
 
 creds_path, name, email = sys.argv[1], sys.argv[2], sys.argv[3]
 R='\033[0m'; B='\033[1m'; D='\033[2m'
@@ -408,11 +417,43 @@ GR='\033[32m'; YL='\033[33m'; RD='\033[31m'; CY='\033[36m'
 print(f'  {B}Account:{R} {GR}{B}{name}{R}')
 print(f'  {B}Email:{R}   {email}')
 
+# ponytail: intentional copy of try_refresh() — cmd_status has its own heredoc scope
+def _try_refresh(cred_path):
+    try:
+        d2 = json.load(open(cred_path))
+        oauth2 = d2.get('claudeAiOauth') or {}
+        rt = oauth2.get('refreshToken', '')
+        if not rt:
+            return None
+        params = urllib.parse.urlencode({'grant_type': 'refresh_token', 'refresh_token': rt}).encode()
+        req2 = urllib.request.Request('https://api.anthropic.com/token', data=params,
+            headers={'Content-Type': 'application/x-www-form-urlencoded', 'User-Agent': 'relay/2.0'})
+        with urllib.request.urlopen(req2, timeout=10) as r2:
+            resp = json.loads(r2.read())
+        oauth2['accessToken'] = resp['access_token']
+        if 'refresh_token' in resp:
+            oauth2['refreshToken'] = resp['refresh_token']
+        oauth2['expiresAt'] = int(datetime.datetime.now(datetime.timezone.utc).timestamp() * 1000) + resp.get('expires_in', 3600) * 1000
+        d2['claudeAiOauth'] = oauth2
+        import os; open(cred_path, 'w').write(json.dumps(d2)); os.chmod(cred_path, 0o600)
+        return oauth2['accessToken']
+    except Exception:
+        return None
+
 try:
     d = json.load(open(creds_path))
-    tok = (d.get('claudeAiOauth') or {}).get('accessToken', '')
+    oauth = d.get('claudeAiOauth') or {}
+    tok = oauth.get('accessToken', '')
     if not tok:
         print(f'\n  {YL}⚠ No access token — please log in again{R}'); sys.exit(0)
+    expires_at_ms = oauth.get('expiresAt', 0)
+    now_ms = datetime.datetime.now(datetime.timezone.utc).timestamp() * 1000
+    if expires_at_ms and now_ms > expires_at_ms - 300000:
+        new_tok = _try_refresh(creds_path)
+        if new_tok:
+            tok = new_tok
+        elif now_ms > expires_at_ms:
+            print(f'\n  {YL}⚠ Token expired — run: relay refresh {name}{R}'); sys.exit(0)
     req = urllib.request.Request(
         'https://api.anthropic.com/api/oauth/usage',
         headers={'Authorization': 'Bearer ' + tok, 'User-Agent': 'relay/2.0'})
@@ -569,6 +610,55 @@ cmd_refresh() {
   ok "Account '${B}${name}${R}' refreshed  ${D}$(get_meta_email "${name}")${R}"
 }
 
+cmd_refresh_all() {
+  hdr "Refresh all accounts (silent OAuth)"
+  local names=()
+  while IFS= read -r f; do
+    names+=("$(basename "${f%.json}")")
+  done < <(find "${CREDS_DIR}" -maxdepth 1 -name '*.json' 2>/dev/null | sort)
+  [[ ${#names[@]} -eq 0 ]] && { warn "No accounts found"; return 0; }
+  "${PY}" - "${CREDS_DIR}" "${#names[@]}" "${names[@]}" <<'EOF'
+import json, sys, datetime, urllib.request, urllib.parse, os
+
+creds_dir, n = sys.argv[1], int(sys.argv[2])
+names = sys.argv[3:3+n]
+R='\033[0m'; B='\033[1m'; GR='\033[32m'; YL='\033[33m'; RD='\033[31m'
+
+# ponytail: intentional copy of try_refresh() — self-contained heredoc scope
+def try_refresh(name, cred_path):
+    try:
+        d = json.load(open(cred_path))
+        oauth = d.get('claudeAiOauth') or {}
+        rt = oauth.get('refreshToken', '')
+        if not rt:
+            return None
+        params = urllib.parse.urlencode({'grant_type': 'refresh_token', 'refresh_token': rt}).encode()
+        req = urllib.request.Request('https://api.anthropic.com/token', data=params,
+            headers={'Content-Type': 'application/x-www-form-urlencoded', 'User-Agent': 'relay/2.0'})
+        with urllib.request.urlopen(req, timeout=10) as r:
+            resp = json.loads(r.read())
+        oauth['accessToken'] = resp['access_token']
+        if 'refresh_token' in resp:
+            oauth['refreshToken'] = resp['refresh_token']
+        oauth['expiresAt'] = int(datetime.datetime.now(datetime.timezone.utc).timestamp() * 1000) + resp.get('expires_in', 3600) * 1000
+        d['claudeAiOauth'] = oauth
+        open(cred_path, 'w').write(json.dumps(d))
+        os.chmod(cred_path, 0o600)
+        return oauth['accessToken']
+    except Exception:
+        return None
+
+for name in names:
+    cred_path = os.path.join(creds_dir, name + '.json')
+    result = try_refresh(name, cred_path)
+    if result:
+        print(f'  {GR}✓{R}  {B}{name}{R}  refreshed')
+    else:
+        print(f'  {YL}⚠{R}  {B}{name}{R}  refresh failed (token may already be fresh or refreshToken expired)')
+print()
+EOF
+}
+
 cmd_remove() {
   local name="${1:-}"
   [[ -z "${name}" ]] && { err "usage: relay remove <name>"; exit 1; }
@@ -781,6 +871,35 @@ def save_cache(c):
         with open(CACHE_FILE, 'w') as f: json.dump(c, f)
     except: pass
 
+# ponytail: intentional copy of try_refresh() — daemon is a standalone extracted script
+def try_refresh_daemon(name, cred_path):
+    try:
+        d = json.load(open(cred_path))
+        oauth = d.get('claudeAiOauth') or {}
+        rt = oauth.get('refreshToken', '')
+        if not rt:
+            return None
+        import urllib.parse
+        params = urllib.parse.urlencode({'grant_type': 'refresh_token', 'refresh_token': rt}).encode()
+        req = urllib.request.Request('https://api.anthropic.com/token', data=params,
+            headers={'Content-Type': 'application/x-www-form-urlencoded', 'User-Agent': 'relay/2.0'})
+        with urllib.request.urlopen(req, timeout=10) as r:
+            resp = json.loads(r.read())
+        oauth['accessToken'] = resp['access_token']
+        if 'refresh_token' in resp:
+            oauth['refreshToken'] = resp['refresh_token']
+        oauth['expiresAt'] = int(time.time() * 1000) + resp.get('expires_in', 3600) * 1000
+        d['claudeAiOauth'] = oauth
+        content = json.dumps(d)
+        open(cred_path, 'w').write(content)
+        os.chmod(cred_path, 0o600)
+        current = open(CURRENT_FILE).read().strip() if os.path.exists(CURRENT_FILE) else ''
+        if name == current:
+            kc_write(content)  # critical: update keychain so do_switch() doesn't clobber
+        return oauth['accessToken']
+    except Exception:
+        return None
+
 def fetch_usage(name):
     cred_path = os.path.join(CREDS_DIR, name + '.json')
     try:
@@ -791,7 +910,12 @@ def fetch_usage(name):
 
         expires_at_ms = oauth.get('expiresAt', 0)
         now_ms = time.time() * 1000
-        if expires_at_ms and now_ms > expires_at_ms: return 'expired'
+        if expires_at_ms and now_ms > expires_at_ms - 300000:
+            new_tok = try_refresh_daemon(name, cred_path)
+            if new_tok:
+                tok = new_tok
+            elif now_ms > expires_at_ms:
+                return 'expired'
 
         c = load_cache()
         entry = c.get(name)
@@ -835,8 +959,18 @@ def main():
     check_single_instance()
     rotate_log()
     log_event('start')
+    last_refresh_ts = 0
 
     while True:
+        # Proactive refresh: every 30 minutes, refresh all account tokens
+        if time.time() - last_refresh_ts > 1800:
+            if os.path.isdir(CREDS_DIR):
+                for cred_file in os.listdir(CREDS_DIR):
+                    if cred_file.endswith('.json'):
+                        acct = cred_file[:-5]
+                        try_refresh_daemon(acct, os.path.join(CREDS_DIR, cred_file))
+            last_refresh_ts = time.time()
+
         cfg = load_config()
         if not cfg:
             time.sleep(60); continue
@@ -986,7 +1120,7 @@ print(' → '.join(names) + ' → (cycle)')")
   echo ""
   ok "Config saved to ${cfg_file}"
   echo ""
-  "${PY}" -c "
+  "${PY}" - "${cfg_file}" <<'PYEOF'
 import json, sys
 cfg = json.load(open(sys.argv[1]))
 R='\033[0m'; B='\033[1m'; D='\033[2m'; CY='\033[36m'
@@ -994,8 +1128,9 @@ for i, name in enumerate(cfg['order'], 1):
     thr = cfg['thresholds'].get(name, '?')
     print(f'    {D}{i}.{R} {name:<14} → switch at {CY}{thr}%{R}')
 p = cfg['poll']
-print(f\"\n    {D}polling: {p[\"low_minutes\"]}min normal / {p[\"high_minutes\"]}min fast (fast above {p[\"high_threshold\"]}%){R}\")
-" "${cfg_file}"
+lo, hi, thr = p['low_minutes'], p['high_minutes'], p['high_threshold']
+print(f'\n    {D}polling: {lo}min normal / {hi}min fast (fast above {thr}%){R}')
+PYEOF
   echo ""
   log "Run ${CY}relay autoswitch start${R} to activate"
 }
@@ -1094,6 +1229,7 @@ cmd_autoswitch_stop() {
 }
 
 cmd_autoswitch_status() {
+  _check_update_bg
   hdr "autoswitch — status"
 
   local pid; pid=$(cat "${RELAY_DIR}/autoswitch.lock" 2>/dev/null || echo "")
@@ -1106,6 +1242,7 @@ cmd_autoswitch_status() {
   local cfg="${RELAY_DIR}/autoswitch.json"
   if [[ ! -f "${cfg}" ]]; then
     warn "No config. Run: relay autoswitch config"
+    _show_update_notice
     return 0
   fi
 
@@ -1173,12 +1310,18 @@ except: pass
 EOF
 
   echo ""
-  log "Run ${CY}relay autoswitch log${R} to see full history"
+  printf "  ${D}────────────────────────────────────────${R}\n"
+  printf "  %-34s %s\n" "  ${CY}relay autoswitch start${R}"  "start daemon"
+  printf "  %-34s %s\n" "  ${CY}relay autoswitch stop${R}"   "stop daemon"
+  printf "  %-34s %s\n" "  ${CY}relay autoswitch config${R}" "edit settings"
+  printf "  %-34s %s\n" "  ${CY}relay autoswitch log${R}"    "switch history"
+  _show_update_notice
 }
 
 cmd_autoswitch_log() {
+  _check_update_bg
   local log_file="${RELAY_DIR}/autoswitch.log"
-  [[ -f "${log_file}" ]] || { warn "No log yet"; return 0; }
+  [[ -f "${log_file}" ]] || { warn "No log yet"; _show_update_notice; return 0; }
 
   hdr "autoswitch — log (last 20 events)"
   "${PY}" - "${log_file}" <<'EOF'
@@ -1201,6 +1344,7 @@ for line in lines[-20:]:
             print(f'  {D}{ts}{R}  {D}daemon start{R}')
     except: pass
 EOF
+  _show_update_notice
 }
 
 cmd_autoswitch() {
@@ -1212,13 +1356,11 @@ cmd_autoswitch() {
     status)  cmd_autoswitch_status ;;
     log)     cmd_autoswitch_log ;;
     *)
-      hdr "autoswitch"
-      printf "  %-32s %s\n" "  relay autoswitch config"  "interactive setup wizard"
-      printf "  %-32s %s\n" "  relay autoswitch start"   "install and start daemon"
-      printf "  %-32s %s\n" "  relay autoswitch stop"    "stop and remove daemon"
-      printf "  %-32s %s\n" "  relay autoswitch status"  "show daemon state + config"
-      printf "  %-32s %s\n" "  relay autoswitch log"     "show recent switch history"
-      echo ""
+      if [[ ! -f "${RELAY_DIR}/autoswitch.json" ]]; then
+        cmd_autoswitch_config
+      else
+        cmd_autoswitch_status
+      fi
       ;;
   esac
 }
@@ -1335,7 +1477,12 @@ PYEOF
     warn "Could not determine latest version — check your network"
     log "To update manually: ${CY}npm install -g @dst-justin/relay@latest${R}"
     return 1
-  elif [[ "${current}" == "${latest}" ]]; then
+  fi
+
+  # Refresh cache with this live result so display commands reflect it immediately
+  printf '%s:%s' "$(date +%s)" "${latest}" > "${UPDATE_CACHE}" 2>/dev/null || true
+
+  if [[ "${current}" == "${latest}" ]]; then
     ok "Already up to date (${current})"; return 0
   else
     log "Latest available: ${B}${latest}${R}"
@@ -1418,6 +1565,7 @@ cmd_help() {
   printf "  %-32s %s\n" "  relay add <name>"         "add account via browser login"
   printf "  %-32s %s\n" "  relay add-force <name>"   "force re-login for existing account"
   printf "  %-32s %s\n" "  relay refresh <name>"     "re-login to refresh an expired token"
+  printf "  %-32s %s\n" "  relay refresh-all"        "silent OAuth refresh for all accounts"
   printf "  %-32s %s\n" "  relay save <name>"        "save current login state"
   printf "  %-32s %s\n" "  relay rename <old> <new>" "rename an account"
   printf "  %-32s %s\n" "  relay list"               "full list with weekly usage"
@@ -1453,6 +1601,7 @@ case "${CMD}" in
     cmd_add "$@" ;;
   save)             cmd_save "$@" ;;
   refresh)          cmd_refresh "$@" ;;
+  refresh-all)      cmd_refresh_all ;;
   switch|sw|use)
     if [[ -z "${1:-}" ]]; then cmd_quick
     elif [[ "${1}" =~ ^[0-9]+$ ]]; then

package/relay.ps1

@@ -120,6 +120,27 @@ function Get-Usage($tok) {
     } catch { return $null }
 }
 
+# ponytail: intentional copy of try_refresh() — relay.ps1 is a standalone Windows script
+function Invoke-TokenRefresh($credPath) {
+    try {
+        $d     = Get-Content $credPath -Raw | ConvertFrom-Json
+        $oauth = $d.claudeAiOauth
+        $rt    = $oauth.refreshToken
+        if (-not $rt) { return $null }
+        $body  = "grant_type=refresh_token&refresh_token=$([System.Uri]::EscapeDataString($rt))"
+        $resp  = Invoke-RestMethod "https://api.anthropic.com/token" -Method Post `
+                     -Body $body -ContentType "application/x-www-form-urlencoded" `
+                     -Headers @{ "User-Agent" = "relay/2.0" } -TimeoutSec 10
+        $oauth.accessToken = $resp.access_token
+        if ($resp.refresh_token) { $oauth.refreshToken = $resp.refresh_token }
+        $expiresMs = [System.DateTimeOffset]::UtcNow.ToUnixTimeMilliseconds() + ($resp.expires_in ?? 3600) * 1000
+        $oauth | Add-Member -NotePropertyName expiresAt -NotePropertyValue $expiresMs -Force
+        $d.claudeAiOauth = $oauth
+        $d | ConvertTo-Json -Depth 10 | Set-Content $credPath -Encoding UTF8
+        return $resp.access_token
+    } catch { return $null }
+}
+
 function New-Bar([int]$pct, [int]$w = 10) {
     $f = [int]([Math]::Round($pct / 100.0 * $w))
     $c = if ($pct -lt 50) { $GR } elseif ($pct -lt 80) { $YL } else { $RD }
@@ -174,8 +195,22 @@ function Show-Table([string]$mode, [bool]$noUsage = $false) {
     if (-not $noUsage) {
         Write-Host "  ${D}fetching usage...${R}" -NoNewline
         foreach ($n in $names) {
-            $tok = Get-Token (Get-Content (Get-CredsPath $n) -Raw -ErrorAction SilentlyContinue)
-            $usage[$n] = if ($tok) { Get-Usage $tok } else { $null }
+            $credPath = Get-CredsPath $n
+            $raw = Get-Content $credPath -Raw -ErrorAction SilentlyContinue
+            $tok = Get-Token $raw
+            if ($tok) {
+                # Pre-emptive: try refresh if within 5 minutes of expiry
+                try {
+                    $oauth = ($raw | ConvertFrom-Json).claudeAiOauth
+                    $expiresAt = $oauth.expiresAt
+                    $nowMs = [System.DateTimeOffset]::UtcNow.ToUnixTimeMilliseconds()
+                    if ($expiresAt -and $nowMs -gt ($expiresAt - 300000)) {
+                        $newTok = Invoke-TokenRefresh $credPath
+                        if ($newTok) { $tok = $newTok }
+                    }
+                } catch {}
+                $usage[$n] = Get-Usage $tok
+            } else { $usage[$n] = $null }
         }
         Write-Host "`r$(' ' * 25)`r" -NoNewline
     }