Hermes Agent Archive / Commands

hermes usage

From Official Docs · September 24, 2026

Show the configured account's rate-limit windows (the /usage block) without a session; --json for scripts.

The account-limits block of the /usage slash command — Codex 5-hour / weekly windows, plan and banked resets; Anthropic OAuth windows; OpenRouter credits — without starting a session, so shell scripts and cron jobs can read it.

Credentials resolve exactly as they do for /usage in a session with no live agent (the auth store, then the credential pool); the command never adds or refreshes a credential it would not use for chat. Exit code 0 on success; 1 with a single stderr line when no credential is configured for the provider, the provider has no usage endpoint, or the fetch fails (stdout stays empty).

--json schema (keys are stable; new keys may be added):

used_percent is null when the provider did not report the window; resets_at is ISO-8601 UTC or null (some windows carry a free-text detail instead); plan is null when unknown.

From the official Hermes Agent CLI reference.

hermes usage