sidinsearch avatar

BugProof

sidinsearch/bugproof

Wraps the BugProof CLI for capturing, replaying, and analyzing executable bug artifacts inside Claude and other MCP hosts. Exposes 10 tools including capture (wrap failing commands), replay (run .bug files and verify failures), inspect (read artifact metadata), and diff (compare two captures). Also surfaces Resources for reading raw .bug contents and Prompts for workflows like "replay and analyze root cause." Useful when you're debugging flaky tests or environment-specific failures and want the agent to capture the exact failure state, replay it deterministically, or compare artifacts from CI versus local runs. Communicates over stdio and shells out to the local bugproof CLI with JSON output.

tools
10
transport
STDIO
last updated
May 31, 2026

Tools

10 tools

Public tool metadata for what this MCP can expose to an agent.

captureRun a command, capture as .bug artifact

Run a command, capture as .bug artifact

No parameter schema in public metadata yet.

replayReplay a .bug file, return verdict

Replay a .bug file, return verdict

No parameter schema in public metadata yet.

inspectShow artifact metadata

Show artifact metadata

No parameter schema in public metadata yet.

diffCompare two artifacts

Compare two artifacts

No parameter schema in public metadata yet.

doctorCheck sandbox capabilities

Check sandbox capabilities

No parameter schema in public metadata yet.

shareShare artifact via GitHub Gist

Share artifact via GitHub Gist

No parameter schema in public metadata yet.

pullDownload artifact from Gist

Download artifact from Gist

No parameter schema in public metadata yet.

watchAuto-capture on command failure

Auto-capture on command failure

No parameter schema in public metadata yet.

listList .bug artifacts in directory

List .bug artifacts in directory

No parameter schema in public metadata yet.

cleanRemove .bug artifacts

Remove .bug artifacts

No parameter schema in public metadata yet.

Sponsors

Readme

BugProof

BugProof Logo

Executable bugs, not bug reports.

Capture a failing command into a portable .bug artifact that anyone can replay on their machine — same code, same env, same failure. Cryptographically signable. Cross-platform. Zero containers required.

npm version License: AGPL v3 Node.js Cross-Platform

https://github.com/user-attachments/assets/2315cfee-3ccf-40d7-830e-3a3d23731ab8



Why BugProof

"Works on my machine" is not a bug report.


View the full README on GitHub

Details

Repository
github.com/sidinsearch/bugproof
Website
github.com/sidinsearch/BugProof
Package
bugproof
Transport
STDIO
Registry
MCP registry, active