DebugPatch Bridge

Local Node bridge for pairing a developer machine with DebugPatch.

Install

npm install -g debugpatch-bridge

Or run without installing:

npx debugpatch-bridge pair --server http://localhost:3000 --code DPB1-2345

How pairing verifies the project

Run the pairing command from inside the repository selected in DebugPatch.

The bridge runs:

git rev-parse --show-toplevel
git remote get-url origin
git branch --show-current

Then it normalizes the GitHub remote to owner/repo and sends a SHA-256 fingerprint of that repository to DebugPatch. The server only accepts the pairing if the fingerprint matches the project repository selected in the web app.

This means VS Code itself is not trusted as the source of truth. The Git repository under the terminal is.

Commands

debugpatch-bridge pair --server http://localhost:3000 --code DPB1-2345
debugpatch-bridge heartbeat
debugpatch-bridge status

Codex integration TODO

The next step is adding a job loop:

debugpatch-bridge run

That loop will poll DebugPatch for local jobs, write DEBUGPATCH_TASK.md, run codex exec, stream logs back, and push the isolated run branch for developer review.