Skip to content

Receipts

Verification for every AI agent.

An agent says done. Receipts checks for an observed destination object, bound to the exact package you approved.

Open source · MIT licensed · No signup

01 · Destination evidence

Check what actually landed.

A successful tool response is not independent proof of delivery. Receipts records the destination account and object, the action, the approved package digest, and when the observation was made. It keeps two evidence paths clearly separate.

Independent read

A locally configured Receipts connector reads the destination itself. The receipt identifies that evidence as independently verified.

receipts-read

Host-supplied observation

Your application, chat integration, or a person supplies the observation. It can be bound to a package, but is not marked as independently verified.

host-supplied

GitHub issues is the first independent provider connector. It verifies the exact repository and issue ID, then checks the title and body against the approved package. Labels, comments, assignees, and issue state are outside that package identity. Read the connector details.

02 · Package binding + retry laws

One action. A clear next step.

Receipts binds the observed object to the exact approved package. When delivery is uncertain, its executor wrapper blocks another write and supports reading back the existing object. A verdict never authorizes an automatic retry or a second write.

completeA matching observation.
An observed destination object is bound to the approved package. Check its proof source and observation time; recheck when you need a current view.
delivery_unknownRead before another write.
The action may have landed, even if its response was lost. Read the destination to find the existing object. Do not automatically retry or create a second one.
package_unverifiedCheck the existing object.
An object exists, but its approved package binding is missing or does not match. Inspect and bind that object instead of creating another.
prewriteResolve what stopped the action.
There is no destination evidence, or the action is confirmed never to have reached it. Rearm only with affirmative prewrite evidence, a fixed cause, a new digest, and a new attempt.

These protections apply to writes routed through the executor. Cooperating writers must share a durable audit store and retain the original action and destination identity. Receipts records host authorization; it does not authenticate your approval UI or control code outside the wrapper.

03 · Connect your agent

Your tools. Your infrastructure.

Connect through MCP, the TypeScript SDK, or REST. Build verification into workflows with Claude, ChatGPT, Cursor, Grok, LangChain, or your own agent, using the interface your host supports.

Setup depends on the host; these are integration interfaces, not native integrations with every named tool. A Claude plugin is included. Hosted chat connectors need a separately secured gateway; the included HTTP and REST servers listen locally.

04 · Local audit

A record you can inspect.

The audit stays on your disk. Destination content is read in local memory to calculate its digest; the audit does not store issue titles, bodies, or credentials. There is no Receipts-hosted service or telemetry.

Entries are hash chained. A retained head checkpoint helps detect local edits or truncation. This is not a blockchain, a provider signature, or an externally witnessed proof: someone who can rewrite both the log and its checkpoint can forge the history.

A receipt records an observation at a particular time. The destination can change later. Recheck to append a fresh observation without rewriting the original receipt.

Explore the architecture

Get started

Run it on your machine.

Start with the source release. You’ll need Node.js 20 or later. The offline demo needs no credentials and simulates a lost response and recovery using host-supplied evidence.

Open the repository

From source

git clone https://github.com/77systems-ai/receipts.git
cd receipts
npm ci
npm test
npm run demo
MIT licensed

Want the business OS, installed?

Receipts is the free verification tool. 77os is the installed business operating system, with Human Approve and white-glove setup.

Book a demo