measured, not promised

The numbers, with the method and the mistakes

tessera's whole pitch is a comparison: what your agent reads today vs. what a compact, cached, metered answer costs. So here are the tables — including the row where we lost.

1 · Whole-file reads vs. atlas cards (reference workload)

Same questions, two ways of answering. Lower is better; tokens are the counting unit.
Question typeWhole-file readtessera cardRatio
Where is this symbol defined?22,800–46,450~1001.6–302.8×
What calls this function?38,410~220~175×
Which tests cover it?12,900~140~92×
What did we decide about X?thread archaeology41uncountable

Figures from the impact report on the author's own repos. Reproduce with tessera report savings.

2 · The row we fixed in public

code_tree returned far more than it displaced — the meter caught it, and it stayed in the report.
code_treeReturnedDisplacedNet
Before (uncapped, June)367,04552,160+314,885
After (paged outlines)10,72322,820−12,097

3 · What a session costs before you ask anything

Tool schemas are context tax. Default matters.
ProfileSchema tokensToolsSwitch
core (default)~1,2007—
memory (close-out)~900fewerset_profile
full~2,900–4,62715set_profile (mid-session)

4 · Deployment shapes

The same server, three ways.
ShapeBest forCostNotes
Local single-userone dev, one machine$0keychain secrets, local Postgres
Self-hosted team stack2–50 peoplehosting onlytessera stack scaffolds compose + TLS + backups
tessera Cloudteams without opsfrom $8/moin development — hosted MCP + shared Postgres per team

Run the atlas yourself (in-browser, 120 KB wasm)