jackin❯ usage

Synopsis

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.

Scopes

cache accounts

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

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

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

Human output is compact and intended for diagnostics:

  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:

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

jackin status - find running instances and short ids
jackin console - open the Capsule TUI and usage overlay