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

zsh — tessera
❯ cargo install tessera
downloaded tessera v2.1.0 (0BSD) · 3.4s

2 · sync, index, serve

zsh — tessera
❯ 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

agent — mcp tools/call
# 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

agent — mcp tools/call
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

zsh — tessera report savings
❯ 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 →