cost-compact · git:20261012.98359cd · 2026-10-12 · sha256 64c22435653f6045
cost-compact git:20261012.98359cdA
Immutable. This exact content never changes and is served at /api/v1/blob/64c22435653f6045.
---
name: cost-compact
description: Whether to compact now: each recent session's context size, cache state and time left on the cache, the cost of the next turn if it comes back warm or cold, and the break-even chance of being away. Use when the user asks whether to compact, whether a rewrite is coming, or whether the cache is still warm. Accepts --json for the raw document and --days N for the window.
allowed-tools: Bash(${CLAUDE_PLUGIN_ROOT}/scripts/cgcost.py)
---
# cost-compact
```bash
"${CLAUDE_PLUGIN_ROOT}/scripts/cgcost.py" compact
```
Add `--days N` to change the window, or `--json` and print the output verbatim with no narration.
The script resolves the proxy port itself and only reads (GETs). It applies nothing: every command
it prints is for the user to run, so offer it and run one only when asked.
Print the report as is: it is already ranked, priced at the gateway's rates and labelled
`observed` (billed tokens), `modelled` (a counterfactual the proxy computed) or `estimate`
(arithmetic with printed assumptions). Do not add, round up or merge figures, and do not turn an
`estimate` into a promise. If it says the dashboard route is unavailable, the proxy is not running
with `--dashboard` or is an older build; say that and stop.
Quote the break-even sentence as is. If the cache is already cold, say that compacting does not avoid the rewrite on the next turn.