# jackin❯ usage (https://jackin.tailrocks.com/commands/usage/)



## Synopsis [#synopsis]

```bash
jackin usage cache accounts [--format human|json]
jackin usage <INSTANCE> accounts [--sync-host-cache] [--format human|json]
jackin usage <INSTANCE> verify [--format human|json]
```

`jackin usage` reads the same daemon-cached usage and quota snapshots that the
Capsule status bar and usage overlay render. It never polls Claude, Codex, Amp,
or any provider directly from the host command; the selected running Capsule
daemon owns provider refresh, caching, retry, and stale-state decisions.

`<INSTANCE>` accepts a full container name or the short instance id shown by
[`jackin status`](/commands/status/).

## Scopes [#scopes]

### cache accounts [#cache-accounts]

```bash
jackin usage cache accounts
```

Reads the host-global jackin❯ account cache at
`~/.jackin/data/daemon/accounts.db`. This is a read-only command: it does not
create the cache file, poll providers, launch provider CLIs, or repair
credentials. If the cache has not been explicitly seeded yet, it prints an
empty table.

### accounts [#accounts]

```bash
jackin usage jk-k7p9m2xq accounts
```

Prints provider account/quota buckets known to the Capsule daemon: provider,
account label, quota window, status, usage amount, and source.

`--sync-host-cache` also upserts the returned rows into jackin❯'s host-global
account cache at `~/.jackin/data/daemon/accounts.db`. This is an explicit
host-side write, intended as a diagnostic bridge until the long-running host
daemon owns provider refresh and writes that cache itself.

### verify [#verify]

```bash
jackin usage jk-k7p9m2xq verify
```

Checks that every provider quota row known to the Capsule daemon is present and
trusted (fresh enough and from an expected source). Use this after auth or
provider changes to confirm the status bar and usage overlay will see the same
data.

## Output [#output]

Human output is compact and intended for diagnostics:

```text
  jackin❯

usage accounts for jk-k7p9m2xq (k7p9m2xq)

  provider      account                 window        status        usage               source
  ----------------------------------------------------------------------------------------------
  codex         alexey@example.com      session       fresh         37/100 percent      codex-rpc
```

`--format json` wraps the shared protocol shape in a stable command envelope:

```json
{
  "schema_version": "v1",
  "data": {
    "container": "jk-k7p9m2xq-myproj-agent",
    "accounts": [],
    "synced_host_cache_path": null,
    "host_cache_path": null
  }
}
```

## Related [#related]

* [`jackin status`](/commands/status/) - find running instances and short ids
* [`jackin console`](/commands/console/) - open the Capsule TUI and usage overlay