vinceglakas

vinceglakas / receipt-pattern

Public

The Receipt Pattern — auditable AI agent actions in 10 lines. Every agent action leaves a receipt.

19
0
100% credibility
Found Mar 12, 2026 at 18 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A simple pattern and toolkit that makes AI agents record structured receipts for their actions on files, databases, and more, allowing easy auditing and undoing of changes.

How It Works

1
😟 Worry about AI changes

You let an AI helper tweak your project files, but worry it changed more than you asked without a clear record.

2
💡 Discover the Receipt Pattern

You learn about a simple way for AI helpers to leave detailed receipts of every change they make, like a shopping receipt.

3
🛠️ Add receipts to your setup

You easily add a short guide to your project so your AI starts writing receipts automatically after each task.

4
🤖 Run your AI helper

Your AI goes to work on your project, making changes, running tests, or other tasks as usual.

5
📂 Check the receipts folder

You open a simple folder to see clear lists of exactly what the AI did, when, and if it can be undone.

6
🔍 Review or undo actions

You read the receipts to audit everything, and if needed, use the undo tools to reverse specific changes safely.

😌 Full control and peace

Now you have a complete trail of AI actions, can fix issues quickly, and trust your project stays safe.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 18 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is receipt-pattern?

Receipt-pattern makes AI agent actions auditable by requiring structured JSON receipts after every state-changing move, like file writes, API calls, or database updates—fixing the nightmare of vague summaries and surprise git diffs. In TypeScript, it spits receipts into a simple folder for shell queries like grepping failures or listing daily runs, plus tools to query, summarize, and even roll back via pre-captured states. Drop it as a skill into Claude Code or OpenClaw, or prompt any agent to follow the receipt pattern.

Why is it gaining traction?

Zero deps and 10-line integration beat bloated logging libs, with pluggable storage from files to Postgres and built-in rollback handlers for files, DBs, emails. Devs love the human-readable summaries, anomaly tracking, and dry-run previews that turn opaque agent sessions into reversible audits. Unlike stream-of-consciousness logs, receipts enable quick "what broke?" hunts via ls or grep.

Who should use this?

Backend devs running AI agents on live codebases via Claude or OpenClaw, auditing file changes or deploys. Teams with agent-driven workflows hitting APIs, DBs, or emails, needing rollback for payment receipt pattern mishaps. Solo prototypers fearing rogue agents touching prod configs.

Verdict

Worth a spin for any agent-heavy project—pattern delivers real audit power fast. With 18 stars and 1.0% credibility, it's early and unproven; solid docs and examples make it low-risk to prototype, but add tests before trusting rollbacks.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.