All docs

CLI

Read usage locally

Three commands read AI app usage on this machine and send nothing to Cady.

The CLI is not released yet; see Install the CLI.

cady accounts read
claude  k_1a2b3c4d5e6f7a8b9c0d1e2f  Max 20x  weekly 55% left (resets 2026-11-14T05:59:00Z)  [primary/full]
codex  k_0f9e8d7c6b5a4f3e2d1c0b9a  Plus  five_hour 100% left (resets 2026-11-10T02:40:39Z), weekly 98% left (resets 2026-11-16T14:46:22Z)  [primary/full]

One line per signed-in AI app account: its plan, the allowance left in each window and which source answered. It reads the app’s own sign-in on this machine, never changes it and never prints a token.

  • --provider claude|codex|cursor|opencode|all picks the app.
  • --no-network uses the cache and local files only.
  • --json prints a cady.accounts.v1 document.

What ran

cady observe --harness claude --last 5

cady observe reads Claude Code and Codex session logs and prints one cady.observe.v1 JSON document with a record per session. --since takes an ISO time and --session one session id.

cady usage read --host codex --session SESSION_ID

cady usage read prints the usage of one Codex or Claude Code run.

What can go wrong

  • “No signed-in plan accounts found.”: no supported AI app is signed in for this user. --home PATH names a config folder in another place.
  • plan? no allowance reading: the account was found but no source could answer. Run it again without --no-network.

For agents: this page as Markdown.