USAGE.md

# What to paste into "Measure yourself"

The parser accepts three input shapes. Use whichever matches your tool.

## 1. Claude Code  (recommended — gives real cost)
Run in your terminal:
```
npx ccusage@latest --json
```
Paste the ENTIRE output. The parser reads any recent ccusage shape:
- `totals` object, OR `daily` array, OR a flat list of session records
- field names in camelCase (`inputTokens`) or snake_case (`input_tokens`)
- `costUSD` / `totalCost` if present -> real blended $/1M (no estimate marker)

Fields consumed:
```
inputTokens / input_tokens
outputTokens / output_tokens
cacheCreationTokens / cache_creation_input_tokens
cacheReadTokens / cache_read_input_tokens
costUSD / totalCost            (optional -> real $/1M)
```

## 2. Codex
Run in your terminal:
```
ccusage codex --json
```
Paste the ENTIRE output. Codex reports a COMBINED input figure and never
itemizes cache writes, so the row is ESTIMATED and flagged:
- `input_tokens`      (combined: fresh + cached)
- `cached_input_tokens`   -> cache_read (measured)
- `output_tokens` + `reasoning_output_tokens` -> output
- cache_create is estimated by the 2:1 field anchor and clamped >= 0
- every Codex row carries a directional caveat (up=input-heavy / down=output-rich)

## 3. Four numbers (no ccusage available)
Paste four integers in any delimiter, in this order:
```
input output cache_create cache_read
```
Example (the MO§ES verified row):
```
1251211 11296121 128196310 2555179769
```
Cost shows as a list-price estimate (~) since no cost data is supplied.

## Notes
- Only Claude Code ccusage output carries real cost. Codex and four-number
  inputs show ~ list-price estimates for $/1M.
- The board ranks by Y = (Cache*Output)/Input^2. Nothing you paste can change
  another operator's rank — your row is scored by the same fixed formula.