Documentation that stays true to your code

Tesso anchors every reference in your docs to a real symbol in your codebase. Rename a function, move a file, and Tesso tells you exactly which docs just broke. Fix them in a couple of clicks, or let your agent do it for you.

tesso
8 references1 broken
Ask AI

Wallet & fee calculation

BillingUpdated 2 days ago8 references

A holds one user's balance. A deposit is validated, passed through , then rounded by before the balance is credited.

Mermaid
Depositamount > 0 ?
CalculateFeereturn error

rejects a non-positive amount before any fee is applied, so a bad request can never move the balance. Rounding happens once, on the way in, so a half-cent is never lost twice.

Withdrawals

charges the same fee through and refuses to overdraw. Both paths write to the ledger in one transaction, so a failed fee lookup can never leave a balance half-updated.

See also

Codebase

Structbackend/billing/wallet.go6:10

6type Wallet struct {
7 UserID string
8 Balance int64
9 Updated time.Time
10}
.tesso
billing
fees.md
backend
billing
lsp
go.mod
LSP 3/9mcp7 of 8 references resolve

The document in front, the codebase beside it

The document takes the width and a real reading measure, and everything about the code collapses into one panel on the right. Select a reference in the prose and that panel resolves it in place, so nothing floats over what you are reading.

Scroll the window sideways to see the full layout.

How it works

Anchor, verify, repair

A reference is written once, verified against every change, and repaired in place when the code moves.

.tesso/billing/fees.md
1## Fee model
2
3Balances live on the
4[Wallet](symbol:Wallet:struct:3:6)
5for each account holder.
anchored via LSP · struct, lines 3–6
billing/wallet.go
3type Wallet struct {
4 UserID string
5 Balance int64
6}
8func CalculateFee(amt int64) int64 {
9 return amt * feeRate / 100
10}

Features

Built for the codebase, not for a docs portal

Tesso runs inside your repository and connects to the tools already in your workflow. Every feature serves one goal: a document should not be able to go out of date without anyone noticing.

fees.md
Charges run through [CalculateFee](symbol:CalculateFee:func:8:10)
LSP
wallet.go
8func CalculateFee(amount int64) int64 {

References that resolve

A reference in your markdown records the symbol name, its kind and its location. Tesso resolves it through the language server, which distinguishes the Wallet you documented from a word that happens to match.

claude code · tesso-mcp

Agents repair what they change

Connect Tesso over MCP and Claude Code or Cursor can read which references a refactor broke, then repair them in the same pass.

12fee := CalculateFee(amt)
13total := amt - fee

Docs where the code is

Hover a symbol in VS Code to read what it is documented to do, and open the document from there, without a context switch or a search through a wiki.

Fee model

Charges run through CalculateFee.

  • •Deposit: amount minus fee
  • •Transfer: sender debited
editor

Rich editor, plain markdown

Headings, tables, diagrams and AI assistance in a modern editor. What is written to disk is plain markdown, reviewable in a pull request like any other file.

tesso verifyrunning
fees.md5 refs
payouts.md9 refs

on: pull_request

Broken docs fail the buildSoon

Run tesso verify in CI so an unresolved reference blocks the merge rather than reaching whoever reads the document next.

docs reviewed in the same pull request

Your repo, your docs

Markdown alongside the code it describes, versioned in the same commit. A single binary that runs locally and works offline after setup, with no hosted service in the path.

FAQ

Common questions

If yours is not answered here, write to us and we will reply.

Try Tesso before launch

We are working with a small number of teams while Tesso is still taking shape. If out-of-date documentation is a measurable cost where you work, or you would simply like to be one of the first to try it, we would like to hear how you would use it.

  • The binary, the VS Code extension, and the MCP server
  • Direct support from us during setup
  • Influence over what ships before launch

Tell us what you are building and which languages you use. We reply to every message.