cost

NAME

cost — display session cost breakdown by agent

SYNOPSIS

cost [--json] [-h|--help]

DESCRIPTION

cost prints a table showing token usage and estimated dollar cost for the current session. Each row represents an agent — the cone plus any active scoops. A totals row summarizes the session.

Token counts and costs are computed from the model provider's usage metadata attached to each assistant turn. The hourly rate is derived from each agent's active time, rounded to 15-minute intervals.

OPTIONS

--json — output the raw cost data as JSON (for programmatic use)
-h, --help — show usage summary

OUTPUT FORMAT

The default output is a fixed-width table with the following columns:

Agent — name of the agent (cone or scoop name)
Model — model identifier (truncated to 18 chars)
MTok (in/out) — millions of input / output tokens consumed
Cache (r/w) — millions of tokens read from / written to prompt cache
Cost — total dollar cost for that agent
$/hour — effective hourly rate based on active wall-clock time

EXAMPLES

$ cost
Session Cost Breakdown:

  Agent           Model             MTok (in/out)  Cache (r/w)       Cost    $/hour
  ──────────────────────────────────────────────────────────────────────────────────
  cone            claude-sonnet-4    0.42 /  0.08   0.38 /  0.04     $0.67    $2.68
  feed-scoop      claude-sonnet-4    0.11 /  0.03   0.09 /  0.02     $0.18    $1.44
  ──────────────────────────────────────────────────────────────────────────────────
  Total                              0.53 /  0.11   0.47 /  0.06     $0.85

$ cost --json
[
  {
    "name": "cone",
    "type": "cone",
    "model": "claude-sonnet-4-20250514",
    ...
  }
]