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
Illustrative. TwinBridge v1 is REST/JSON-focused and does not support production interception.