# Plot

> clawback chart renderer

- Skill: `zapgun-ai/plot` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zapgun-ai/plot`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zapgun-ai/plot/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zapgun-ai (https://skillmd.com/u/zapgun-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zapgun-ai/plot

---


# clawback chart renderer

Run `benchmark/bin/plot.js` from the project root. It reads an analyzer
**output directory** (the `--out` dir you gave `benchmark/bin/analyze.js`)
and writes TWO SVGs to a charts directory. No dependencies — pure Node + string
templating, so it runs anywhere clawback runs.

## Usage

```bash
node benchmark/bin/plot.js --in runs/smoke --out runs/smoke/charts
```

`--in` must contain `summary.json` and `report.csv` (run `.skills/bench`
first). The SVG is written to `--out`.

## Charts emitted

Both SVGs draw the **same** figure — **cumulative billable input tokens over
turns**, two lines (passthrough baseline vs clawback) with the gap between them
shaded. The shade is honest about direction: **green** when clawback's line ends
*below* passthrough (it spent fewer full-rate tokens — a real saving), **red**
when clawback ends *above* (it spent more — a regression we never hide). The
chart carries **no per-turn reclaim callout**; the report hero overlay owns that
figure now, so a chart copy would only collide with it.

- `tokens_saved.svg` — the **labeled, on-screen** chart: legend, axes, ticks,
  and the title **"Token Efficiency"**. This is what the report GUI shows.
- `tokens_saved.bg.svg` — the **BARE share-card background**: a 1200×630 white
  card with just the two lines + the filled wedge, **zero `<text>`**. The report
  GUI inlines this behind the scrim to build the downloadable / shareable PNG.
  **Missing it ⇒ the share PNG is a solid card with no chart lines.** (Backfill
  old runs that predate it with `.skills/finish --all`.)

One figure on purpose: the product story is "how many more tokens can you spend,
because clawback saves your quota" — not a dashboard of stats, and never a
dollar figure. **Billable input** = `input_tokens + cache_creation_input_tokens`
(the full-rate buckets); `cache_read` is the discounted reuse and is excluded.
Cost lives only in the analyzer's `report.md` appendix; it is never plotted.

## Honest-claim discipline

The win is conditional on idle gaps: on a tight loop the baseline caches well
too, so the gap trends to ~0 (no regression); it widens as gaps cross the
5-min / 60-min eviction boundaries. Read the chart by regime, never as one
context-free number.

## Reproducibility

The charts are a pure function of `summary.json` + `report.csv`; re-rendering
the same analyzer output yields byte-identical SVGs.