How TwinBridge works

Capture real traffic, learn behavior, synthesize a local runtime, and run deterministically in dev or CI.

1) Capture

Capture runs in dev or staging. Sensitive fields are redacted by default.

twinbridge capture --target https://api.vendor.com --out captures/vendor.tbcap

2) Learn

Infer schemas and behavior: error modes, retries, pagination, webhooks, and timing profiles.

  • Contract inference
  • Behavior graph
  • Timing profile (optional)

3) Synthesize

Generate executable twin + manifest for governance and validation.

twinbridge build --capture captures/vendor.tbcap --out twins/vendor/ twinbridge validate --twin twins/vendor/

4) Run

Switch base URL to localhost. Zero latency. No external calls.

twinbridge run --twin twins/vendor/ --port 8080

Architecture at a glance

Your App dev / CI TwinBridge Runtime localhost Behavior Model + Manifest hashes · schema validation · (optional) Ed25519 signatures Capture (.tbcap) dev / staging only · redaction Build + Validate reproducible outputs Optional Signing trust-root.json · key rotation

Illustrative. TwinBridge v1 is REST/JSON-focused and does not support production interception.