The usage reef

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

O reef usage

Todos os comandos que informam a janela de cota de um agente de código e mostram para onde ela vai

Opening · the kind

A UsageWindow is the last reading kept of one quota window

  • UsageWindow: spec has used (0 to 100), resetsAt and readAt; status has timeZone, copied from its Mandate
  • The share only grows: within one window the highest reading wins, and the reset only moves forward
  • Through the Nereus API only: the CLI never opens a kubeconfig (ADR 0018)
Abertura · o kind

Uma UsageWindow é a última leitura guardada de uma janela de cota

  • UsageWindow: o spec tem used (de 0 a 100), resetsAt e readAt; o status tem timeZone, copiado do seu Mandate
  • A fatia só cresce: dentro de uma janela vence a leitura mais alta, e o reset só anda para a frente
  • Só pela Nereus API: a CLI nunca abre um kubeconfig (ADR 0018)
Window · usage reportbuilt #1590

report sends a reading, read now

Janela · usage reportpronto #1590

O report envia uma leitura, feita agora

~/example
# 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✓ usage/windows/weekly reported (75% used, resets Mon 16/11 01:00) Next steps:   nereus usage get weekly
Window · usage offlinebuilt #1592

offline, report keeps the reading locally and get answers from it

Janela · usage offlinepronto #1592

Offline, o report guarda a leitura localmente e o get responde a partir dela

~/example
# Nereus unreachable: the reading goes to the local cache$ nereus usage report weekly \    --used 75 \    --resets-at 2026-11-16T01:00:00-03:00✓ 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 # The figures computed from the cache, marked local$ nereus usage get weeklyWINDOW  USED  RESETS           FORECAST  PACE    TODAY  READweekly  75%   Mon 16/11 01:00  91%       steady  ≤79%   local Sat 19:06
Window · usage applybuilt #1590

apply writes the windows of a file, under the same rules

Janela · usage applypronto #1590

O apply grava as janelas de um arquivo, sob as mesmas regras

~/example
# A file of UsageWindows, or a folder of them$ nereus usage apply \    --from-file weekly.yaml✓ usage/windows/weekly created Next steps:   nereus usage list
Window · usage getbuilt #1591

get shows the forecast at the reset, today's goal and the week day by day

Janela · usage getpronto #1591

O get mostra a previsão no reset, a meta de hoje e a semana dia a dia

~/example
# The times in the window's time zone$ nereus usage get weeklyWINDOW  USED  RESETS           FORECAST  PACE    TODAY  READweekly  75%   Mon 16/11 01:00  91%       steady  ≤75%   Sat 19:06 DAY        SHARE  TOTALMon 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%    todaySun 15/11  +25%   100%   plan
Window · usage list and deletebuilt #1590

list shows every window, delete forgets one

Janela · usage list e deletepronto #1590

O list mostra todas as janelas, o delete esquece uma

~/example
# The same columns as get$ nereus usage listWINDOW  USED  RESETS           FORECAST  PACE    TODAY  READweekly  75%   Mon 16/11 01:00  91%       steady  ≤79%   Sat 19:06 # The window and its reading$ nereus usage delete weeklyusage/windows/weekly deleted Next steps:   nereus usage list