| 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
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
⚠️ 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.
