CLI reference - Multivon Docs

Install with pip install pdfhell, or prefix commands with uvx. Every subcommand is non-interactive and exposes its current options through --help.

`pdfhell list-traps`

Print the 17 registered trap-family names, one per line.

pdfhell list-traps

`pdfhell discover`

Emit the capability catalog as JSON for agents and automation.

pdfhell discover
pdfhell discover --compact

`pdfhell make`

Generate one PDF and its case JSON.

pdfhell make --trap hidden_ocr_mismatch --seed 7001 --out cases

--trap and --seed identify the deterministic case. --out defaults to ./cases.

`pdfhell build`

Materialize a named suite without running a model.

pdfhell build --suite mini-v4-sample --out cases/mini-v4-sample

Available suites are smoke, mini, mini-v2, mini-v3, mini-v4, and mini-v4-sample.

`pdfhell run`

pdfhell run \
  --model anthropic:claude-haiku-4-5 \
  --suite mini-v4-sample \
  --workers 4 \
  --out runs/haiku.json \
  --junit runs/haiku.xml \
  --audit-pack runs/haiku-audit.zip \
  --fail-threshold 0.80

Flag	Default	Meaning
`--model`	required	Provider/model spec such as `openai:gpt-4o`.
`--suite`	`mini`	One of the six registered suite names.
`--cases-dir`	suite-specific path	Use already materialized case files.
`--workers`	`4`	Parallel provider requests.
`--pixels`	off	Rasterize locally and send PNG pages only.
`--dpi`	`150`	Raster resolution for `--pixels`.
`--quiet`	off	Suppress progress output.
`--out`	generated under `runs/`	JSON report path.
`--junit`	unset	Optional JUnit XML path.
`--audit-pack`	unset	Optional hash-chained evidence ZIP.
`--fail-threshold`	unset	Exit nonzero when pass rate is below this value.

Pixels-only mode requires pip install 'pdfhell[pixels]'. The report records the modality, DPI, and pdfium build so it cannot be mistaken for a PDF-input run. Provider credentials come from ANTHROPIC_API_KEY, OPENAI_API_KEY, or GOOGLE_API_KEY, according to the model prefix.

`pdfhell report`

Print the summary and per-family breakdown from an existing run JSON without calling the provider again.

pdfhell report runs/haiku.json

The report surfaces API errors separately. Treat a high error rate as an invalid experiment, not as model failure.

Exit behavior

Successful generation/reporting exits 0.
run exits nonzero when --fail-threshold is set and the measured pass rate is lower.
Invalid flags, missing credentials, malformed cases, and provider failures produce errors rather than a passing gate.

Use pdfhell <command> --help as the authoritative installed-version reference.

​pdfhell list-traps

​pdfhell discover

​pdfhell make

​pdfhell build

​pdfhell run

​pdfhell report

​Exit behavior