Protocolith¶
Records, verifies and issues trial records.
Freeze a protocol before a run, record the outcome, verify the hash-chained history, issue a card. One local
append-only ledger, a command line (protocolith, alias plith), a Python API and an MCP server. Standard
library only; Python 3.11 to 3.15; macOS, Linux and Windows; headless.
protocolith freeze protocol.json
protocolith record record.json
protocolith verify-ledger
protocolith issue 1
Start here¶
-
Try it in two minutes
-
Understand it
-
Use it
Local experiments · CI · Use it from an AI agent · Query the ledger · Python API · Browse experiments (atlas)
-
Look it up
Command reference · MCP tools · Core specification · Error codes
What it proves, and what it does not¶
A valid ledger proves internal consistency and ordering. It does not prove wall-clock time, and it cannot
detect that a whole ledger was replaced or its tail removed unless you anchored the head somewhere else
(anchoring the head). It does not show that a protocol is sound or that data is
true. Check against an anchored head with verify-ledger --expect-head SEQ:HASH.
Status¶
The ledger commands are on the development branch toward 0.6.0 and installable from source today; the specification is a draft (0.1) with one implementation. See the roadmap and the FAQ.
The earlier evidence-card material (card validators, runners, registry views) is kept under Archive and examples. The project was published as ClaimBound Evidence until 0.5.0; see related work and independence.