Skip to content

The usage reef

Every command that reports a coding agent's quota window and shows where it is heading.

Commands

Examples

usage-report

75% used, resetting on Monday at 01:00 in São Paulo.

nereus usage report weekly \
  --used 75 \
  --resets-at 2026-11-16T01:00:00-03:00
output
✓ usage/windows/weekly reported (75% used, resets Mon 16/11 01:00)

Next steps:

  nereus usage get weekly

usage-offline

Nereus unreachable: the reading goes to the local cache.

nereus usage report weekly \
  --used 75 \
  --resets-at 2026-11-16T01:00:00-03:00
output
✓ usage/windows/weekly kept locally (75% used, resets Mon 16/11 01:00): Nereus unreachable, next try in 5m

Next steps:

  nereus usage get weekly

usage-apply

A file of UsageWindows, or a folder of them.

nereus usage apply \
  --from-file weekly.yaml
output
✓ usage/windows/weekly created

Next steps:

  nereus usage list

usage-get

The times in the window's time zone.

nereus usage get weekly
output
WINDOW  USED  RESETS           FORECAST  PACE    TODAY  READ
weekly  75%   Mon 16/11 01:00  91%       steady  ≤75%   Sat 19:06

DAY        SHARE  TOTAL
Mon 09/11  +10%   10%
Tue 10/11  ~+11%  ~21%
Wed 11/11  +10%   31%
Thu 12/11  +10%   41%
Fri 13/11  +19%   60%
Sat 14/11  +15%   75%    today
Sun 15/11  +25%   100%   plan

usage-list-delete

The same columns as get.

nereus usage list
output
WINDOW  USED  RESETS           FORECAST  PACE    TODAY  READ
weekly  75%   Mon 16/11 01:00  91%       steady  ≤79%   Sat 19:06