check-usage-tui

name	check-usage-tui
description	Check provider usage via TUI worker (~30s, costs CLI tokens). FALLBACK when `check-usage-http` returns RATE_LIMIT or fails. Spawns an ephemeral tmux session, runs `/usage` (or `/status` for Codex), parses the modal, kills the session.
allowed-tools	Bash(tmux *), Bash(python3 *)

Skill — Check usage via TUI worker (robusto, ~30s, costoso in token)

QUANDO USARLA

Solo come L2 dopo che L1 (HTTP) ha fallito. È robusta perché bypassa il rate-limit Anthropic (legge dal CLI locale), ma costa:

• ~30s di tempo (spawn worker + boot CLI + render modal)
• alcuni token Claude (apertura sessione + /usage)
• rischio di TUI in stato anomalo (Loading, scaduto, etc.)

Ordine di fallback: HTTP → TUI → FATAL.

Workflow

Step 1 — Provider attivo

python3 -c "import json; print(json.load(open('/jht_home/jht.config.json'))['active_provider'])"

Step 2 — Spawn sessione tmux EFFIMERA

Nome unico col timestamp (no collisione):

SESS="SENTINELLA-WORKER-$(date +%s)"
tmux new-session -d -x 220 -y 50 -s "$SESS" -c /jht_home
tmux send-keys -t "$SESS" "export HOME='/jht_home'" C-m
tmux send-keys -t "$SESS" "export PATH='/app/agents/_tools:/jht_home/.npm-global/bin:\$PATH'" C-m
tmux send-keys -t "$SESS" "export KIMI_CLI_NO_AUTO_UPDATE=1" C-m

Step 3 — Lancia il CLI provider

Provider	Comando
claude / anthropic	claude --dangerously-skip-permissions
kimi / moonshot	kimi --yolo
codex / openai	codex --yolo

tmux send-keys -t "$SESS" "<comando>" C-m
sleep 18   # boot + eventuale trust dialog auto-accept

Step 4 — Slash command

Provider	Slash command
claude / anthropic	/usage
kimi / moonshot	/usage
codex / openai	/status (NON /usage!)

tmux send-keys -t "$SESS" "<slash>" Enter
sleep 4   # render modal

⚠️ NIENTE Esc preventivo prima del slash command: rompe Kimi (interpreta /usage come testo) e per gli altri è inutile in sessione fresh.

Step 5 — Capture pane

tmux capture-pane -t "$SESS" -p -S -100

Leggi il pane coi tuoi occhi LLM, estrai usage, reset, weekly.

Format Claude

Current session
████████  45% used
Resets 8:10pm (UTC)

Current week (all models)
████  25% used
Resets Apr 27, 5am (UTC)

→ usage=45, reset=20:10 UTC, weekly=25

Format Kimi

╭─── API Usage ──────────────────────────────────╮
│ Weekly limit  ━━ 60% left  (resets in 2d 27m) │
│ 5h limit      ━━ 100% left (resets in 3h 27m) │
╰────────────────────────────────────────────────╯

→ usage=100-100=0, weekly=100-60=40 → reset_at: ora_UTC + 3h 27m → calcola HH:MM UTC

Format Codex

5h limit:    [████░░] 35% left (resets 18:10)
Weekly limit: [██░░░░] 88% left (resets 14:00 on 02 May)

→ usage=100-35=65, weekly=100-88=12, reset=18:10

⚠️ Codex riporta "% left", non % used: sottrai da 100.

Step 6 — KILL sessione SUBITO

tmux kill-session -t "$SESS"

⚠️ Killa SEMPRE anche se il parse fallisce. Niente sessioni persistenti.

Step 7 — Scrivi sample nel JSONL

python3 /app/shared/skills/usage_record.py --manual \
    --usage <X> --reset-at <HH:MM> --weekly <W> \
    --provider <claude|kimi|openai> --source sentinella-worker

Step 8 — Procedi con la decisione

Hai ora il sample fresco con proj/status calcolati da compute_metrics. Aggiorna memoria (vedi skill memory-state) e decidi ordine al Capitano (vedi skill order-formats).

Troubleshooting

Pane vuoto / nessuna modal

• CLI non ancora ready → attendi altri 8s e ricaptura.
• Trust dialog ancora aperto → invia Enter (NON Escape: cancella e ti butta in bash).

Loading usage data… infinito (Claude)

TUI bloccato. Kill+respawn la sessione e riprova; se persiste cadi su L3 (FATAL).

Unrecognized command (codex)

Hai mandato /usage su codex. Manda /status e basta.

CLI morto / pane in bash

Kill la sessione e respawna.