Usage CLI reference
Read what your turns cost: today, the window, a row per day, and a row per model.
Use this page to read what atoi usage answers and the flags it takes. The numbers come from the model-decision receipts a turn writes, so the terminal, the atoi_usage tool, and the Usage section of Billing all answer from one place.
atoi usageRead what the turns cost, from the model-decision receipts: today, the window, by day, and by model.
#usage get
Read what your turns cost in the Workspace the terminal is standing in: today, the window, a row per day, and a row per model.
atoi usage [get] [--days <n>] [--workspace <workspace-id>] [--personal]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--days | number | Read this many days back. Seven when omitted. | ||
--workspace | string | Answer one Workspace by id for this call; without it, the Workspace the terminal is standing in. | ||
--personal | boolean | Answer Personal for this call, whatever the terminal is standing in. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run usage get
atoi usage --days 7 --json{
"tool": "atoi_usage",
"arguments": {
"action": "get",
"days": 7
}
}Without --workspace, the read answers for the Workspace the terminal is standing in; --personal steps out to Personal for one call.
Read Billing for the same numbers in the product, or the CLI reference index for every command.
Was this useful?