# 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](https://cadyworks.com/docs/install.md).

```sh
cady accounts read
```

```text
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

```sh
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.

```sh
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`.

Next: [Run your own scripts](https://cadyworks.com/docs/scripts.md)