Docs navigation
CLI reference
Every verb below is real and shipped. Most never touch the network — only replay and engine do, and replay refuses production-class targets structurally.
Verbs
| Verb | Purpose | Network |
|---|---|---|
run | Compare two output sets; decide PASS or FAIL. | Never |
gate | Decide whether a change may deploy. | Never |
corpus | Manage recorded traffic corpora. | Never |
import | Import engine configuration exports. | Never |
parse | Print an HL7 message's field tree with spec names. | Never |
probe | Show exactly what a connector would do, without doing it. | Never |
versions | Print version information. | Never |
replay | Replay a recorded corpus against approved, pinned, non-production targets. | Only to approved non-production targets |
engine | Run the local engine: queues, listeners, retry lanes. | Yes — the interfaces it's configured to run |
Exit-code vocabulary
ivren gate uses a fixed exit-code vocabulary built for CI pipelines. Missing evidence can never become PASS.
| Code | Meaning |
|---|---|
0 | PASS |
1 | FAIL |
2 | Could not complete |
3 | INDETERMINATE |
4 | REFUSED |