Ce face /usage și hermes usage
/usage arată consumul de tokeni, defalcarea costului, durata sesiunii și, când furnizorul activ le oferă, o secțiune Account limits cu cota, creditele sau planul rămase, citite live din API-ul furnizorului. Pe platformele de mesagerie arată și starea ferestrei de context.
hermes usage scoate doar blocul de limite ale contului, fără să pornească o sesiune, pentru scripturi și cron. Furnizori suportați: openai-codex, anthropic, openrouter. Codul de ieșire este 0 la succes și 1 când nu există credențiale, furnizorul nu are endpoint de consum sau citirea eșuează.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
/usage |
Consumul sesiunii și limitele contului. |
--provider NAME |
Furnizorul interogat (implicit model.provider). |
--json |
Un singur document JSON pe stdout. |
Exemple practice
Exemplul 1: Limitele contului în JSON
Exemplul de schemă din documentație (valorile sunt de exemplu).
hermes usage --provider openai-codex --json
Rezultat
{
"provider": "openai-codex",
"source": "usage_api",
"title": "Account limits",
"plan": "Plus",
"fetched_at": "2026-09-19T07:58:55+00:00",
"windows": [
{"label": "Session", "used_percent": 37.0, "resets_at": "2026-09-19T21:00:00+00:00", "detail": null},
{"label": "Weekly", "used_percent": 12.5, "resets_at": "2026-09-25T09:00:00+00:00", "detail": null}
],
"details": ["You have 1 reset banked - use /usage reset to activate"],
"unavailable_reason": null
}
Exemplul 2: În sesiune
/usage
Greșeli frecvente și bune practici
- Aștepți limite de cont pentru orice furnizor.
hermes usagele citește doar pentru furnizorii cu endpoint de consum.