Quick-start · broker / author

Goal: turn an existing OM PDF into an openOM PDF that carries a verifiable, broker-asserted payload - without changing a single visible pixel.

Option A - embed in your browser (no install at all)

Open the web authoring companion, drop in your OM PDF, fill the deal fields, and assert & embed - then download the openOM PDF. The bytes never leave your browser, the visible pages are untouched, and you review every field before it is stamped with your name and the date (that page is the assertion gate). Nothing to install.

Option B - the browser extension

Install the extension (Chrome 116+), open your OM, use author mode to review the fields, then assert and embed. Optional on-device extraction pre-fills a draft - and never leaves your machine. Same assertion gate as the web companion.

Option C - the CLI (scriptable / server-side / whole back-catalog)

From a clone of the repo (a published PyPI package is on the way). Grab a deal.json starter payload, edit the values, then:

pip install -e core -e cli    # from a checkout; PyPI package coming soon
curl -O https://openom.app/sample/deal.json   # a valid starter payload to edit

om embed offering.pdf --payload deal.json --out offering.openom.pdf --asserted-date 2026-08-18
om read  offering.openom.pdf          # confirm the payload round-trips
om validate deal.json                 # schema errors block; consistency warnings never do

Every payload needs assertedBy + assertedDate and an noiType (in-place or pro-forma). Re-embedding replaces (never stacks) and records meta.supersedes.

Then: get it in front of buyers

Upload the openOM PDF exactly as-is. Don't let a listing portal re-export, flatten, or "optimize" it - re-exporting silently strips the embedded payload (the file still looks identical). Confirm a live listing survived by running its URL back through the verify tool.

Next: the field reference for exactly what goes in deal.json.