Fleet docs v0.2.0-rc.448

Claude usage

Your Claude profiles, their state, and the last usage readings of each one: how much of each limit is used, and when it resets.

How to read it

  • Your profiles: one row for each profile: its id, its kind, default if it is your default, and a badge. Green ok means that turns can use it. Yellow <state> until <time> means that it is limited until that time.
  • Under each profile: one reading for each limit type. It shows the percent used, a yellow badge if the status is not allowed, and "resets … (in …)". The meter is yellow at 80 % and red at 90 %.
  • "read … ago" says how old the reading is. A reading comes only when a turn on that profile ends.
  • The quota file is a fallback. It shows only if no profile has a reading. Interactive Claude Code sessions write it, not fleet turns.
  • If more than one box sends usage, the panel shows one part for each box.

When it looks wrong

You see It means Do this
"no credential profile yet" You have no profile fleet profile add main --kind subscription --default
"no reading yet: a turn on this profile reports one" No turn on this profile ended yet Nothing. Wait for a turn to end.
A yellow limited until … The account is at its limit. Its agents are paused. Wait for the reset, or move an agent: fleet agent profile <agent> <profile>. See a usage limit.
limited with the reason auth The login does not work Make a new token and run fleet profile rotate <name>
"reset time unknown" The limit message had no reset time fleet tries again after 1 h
A quota-file error ("no such file or directory") dash.quota_file names a file that is not there Fix the path, or remove the key
"Your profiles" is not there, but boxes show usage A known fault: with more than one box with usage, or before the first quota-file read, the page does not show the profiles Use fleet profile ls

Members see only their own profiles. Admins also see profiles with no owner. The filter does not change this panel. Code: fleet/internal/api/state.go (usage), fleet/internal/dash/usage.go.