tessera — quickstart
One Postgres, one MCP server, every harness. Everything below is real output from the reference workload — including the calls that lost.
1 · install
❯ cargo install tessera downloaded tessera v2.1.0 (0BSD) · 3.4s
2 · sync, index, serve
❯ tessera sync --open synced 412 tickets (37 open) · 1 backend · 12s ❯ tessera index --all tessera: 110 indexed, 0 skipped, 0 deleted, 1919 symbols ❯ tessera mcp serving stdio MCP · core profile · 7 tools (1.2k schema tokens)
3 · what the agent actually gets
# instead of reading src/reaper.rs (22,800 tokens): code_workpack "reap_droplets" → card + 6 references + 2 tests · ~100 tokens # instead of guessing which discussion settled this: recall query="tokyo region" → decision #297 (active, 2026-05) + supersedes #295 · 41 tokens # the bad news, kept public: code_tree (uncapped) 367,045 returned vs 52,160 displaced · +315k code_tree (paged) 10,723 returned vs 22,820 displaced · −12k
4 · memory writes are explicit
remember kind="decision" scope="repo:tessera" text="bridge sessions run one tessera mcp child over the agent tunnel" → stored id 3 · supersede chain armed # drafts only a human can push; state docs use compare-and-set
5 · the meter, uncropped
❯ tessera report savings net displacement 1.6×–302.8× on 1,204 calls calls that did not pay for themselves: 17 (listed)
Prefer to touch it before installing? The same atlas core cross-compiled to WebAssembly, indexing this project in your browser.
open the wasm demo →