ooml CLI

CLI for the OOML Registry. Talks to registry.ooml.org by default.

Installing

npm install -g @ooml-org/cli

Commands

• ooml login — device-flow authentication. Prints a code, opens the registry's /device confirmation page, and polls until confirmed. Saves the resulting token to ~/.ooml/config.json.
• ooml claim <namespace> — claims an unverified namespace under your account. Needed before you can publish anything under it.
• ooml verify <namespace> [--method dns_txt|well_known] — starts a domain-ownership challenge, or checks a pending one if you've already run it once. Prints the DNS TXT record (or well-known file) to set up; run it again after that's in place to complete verification.
• ooml publish <file> — publishes a local OOML artefact JSON file. The file's own fqn field is the artefact's identity — no separate flags, and nothing is repeated in a URL.
• ooml resolve <range> — resolves an FQN range (e.g. com.example.hr/Employee@^1.2.0) and prints the resolved artefact. Doesn't require login.
• ooml dispute <namespace> <reason> [--fqn-base <fqnBase>] [--details <text>] — files an abuse report (reason: impersonation, trademark, abandoned, or other), routed straight to manual review.
• ooml reconciliation-case <caseId> — shows a reconciliation case's current status.
• ooml contest <caseId> — contests an open reconciliation case, as its prior owner.
• ooml org create <name> — creates an org.
• ooml search <query> — not yet available.

Development

npm install
npm run dev -- login          # runs via tsx, no build step
npm run build                 # bundles to dist/index.js
node dist/index.js --help

To test a local build as the global ooml command:

npm link       # overrides any npm -g install until you `npm unlink -g`