CLI
npx @pressline/cli --url https://shop.example --token $OPERATOR_TOKEN <command>--url and --token belong to the CLI rather than to a subcommand, so they come before the command name, and can instead come from PRESSLINE_URL and PRESSLINE_TOKEN. The CLI never touches the database. The Operator’s commands are clients of the operator API and need the token. offers reads a public endpoint of the instance and needs only the URL. engine … commands talk to the Engine, to files on disk, or to that same public endpoint, and need no token.
Operator
Section titled “Operator”| Command | What it does |
|---|---|
doctor |
Config, secrets, provider reachability, Engine health, webhook registration; exit 1 with the problems |
catalog search <text> |
Printful products by name with variants, Specs and an Offer snippet |
catalog check |
Every configured Offer resolves |
webhooks register [--public-url] |
Create or verify both webhook endpoints; prints the secrets once |
orders list [--state] [--limit] · orders show <id> |
The ledger |
orders create … --paid-outside [--send-email] |
An order paid outside Stripe (reprint, offline sale) |
orders resubmit <id> · orders fix-address <id> … · orders cancel <id> |
Recovery without provider dashboards |
orders purge --older-than <days> |
Strip personal data from finished orders |
reconcile [--dry-run] |
Run Reconciliation now |
printfile check <url> --offer --variant [--strict] |
Any image URL against an Offer variant’s Spec, with its Inspection |
Engine developer
Section titled “Engine developer”| Command | What it does |
|---|---|
offers [--json] |
The Offers this instance sells, one line per distinct Printfile Spec with the variant keys that share it; no token |
engine conformance <baseUrl> --secret --design [--dpi] [--timeout] [--any-shape] [--strict] [--format png|jpeg] [--json] |
Run the conformance suite against an Engine |
engine preflight <paths…> [--offer --variant | --spec] [--strict] [--json] |
Preflight local Printfiles against a Spec, before they are hosted |
offers needs --url; engine conformance needs neither --url nor --token, and engine preflight needs --url only when it takes the Spec from an instance with --offer. pressline-conformance from @pressline/conformance remains as an alias of engine conformance.