gitwtfhub

wtf is proofpatch?

zoroo2626/proofpatch — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A verification tool that proves an AI coding agent's patch actually fixes a bug, using isolated Git clones and Docker sandboxes before trusting it.

Mindmap

mindmap
  root((ProofPatch))
    What it does
      Reproduce bug first
      Isolated agent patch
      Verify then apply
    Features
      Proof receipts
      Docker sandboxing
      Regression checks
    Tech stack
      Python
      Docker
      Git
    Use cases
      Verify AI agent fixes
      Audit patch evidence
      Prevent false fixes
    Setup
      Python 3.12 plus
      pip install
      proofpatch run command

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Verify that an AI coding agent's bug fix actually resolves the reported issue before merging it.

REASON 2

Run agent generated patches inside an isolated Git clone and Docker sandbox.

REASON 3

Keep an evidence trail proving a patch passed baseline reproduction and regression checks.

REASON 4

Add a trust layer between an AI agent's patch and your production repository.

What's in the stack?

PythonDockerGit

How it stacks up

zoroo2626/proofpatch0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Docker with Linux container support for the isolated protected execution step.

Licensed under Apache 2.0, which allows free use, modification, and commercial use as long as you keep the license and copyright notice.

Wtf does this do

ProofPatch is a verification tool built for a world where AI coding agents write bug fixes. Its core problem statement is simple: an agent saying a patch fixed a bug does not mean the bug is actually fixed, so ProofPatch sets up a controlled process to prove it before the patch is trusted. The workflow runs in five steps. First, a bug report is turned into something testable. Second, the failure has to actually be reproduced before any patching starts, so there is a real baseline to compare against. Third, the coding agent writes its patch inside a disposable Git clone rather than touching the real repository. Fourth, a fresh isolated workspace checks that the original failure is gone and that other existing checks still pass. Fifth, ProofPatch writes out a proof receipt recording the patch and the verification evidence, so someone can review it later. Other features include Docker based protected execution so patches run in a sandboxed environment, Git based isolation so the original codebase is never touched directly, support for different agent adapters, and general regression checking to catch a fix that breaks something else. Setting it up requires Python 3.12 or newer, Git, and Docker with Linux container support for the protected execution step. After installing it with pip, you initialize a starter configuration for your project, review and adjust the generated settings file, then kick off a run pointing at a described issue. ProofPatch gives back a run ID you can use to check status, inspect the stored receipt, and if everything checks out, apply the verified patch to a new branch in your actual repository. The project is licensed under the Apache License 2.0.

Yoink these prompts

Prompt 1
Walk me through running proofpatch init and proofpatch doctor to set up this tool for my Python project.
Prompt 2
Show me how to configure proofpatch.yml with my own agent command and verifier image.
Prompt 3
Explain the five step ProofPatch workflow from bug report to proof receipt.
Prompt 4
Help me interpret a proofpatch receipt output and decide whether to apply the patch.

Frequently asked questions

wtf is proofpatch?

A verification tool that proves an AI coding agent's patch actually fixes a bug, using isolated Git clones and Docker sandboxes before trusting it.

What language is proofpatch written in?

Mainly Python. The stack also includes Python, Docker, Git.

What license does proofpatch use?

Licensed under Apache 2.0, which allows free use, modification, and commercial use as long as you keep the license and copyright notice.

How hard is proofpatch to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is proofpatch for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.