Wilfie CLI

Wilfie is a command-line client for Wilfie APIs.

Use it to authenticate and run workspace, workflow, and WMS commands from your terminal.

Install

uv tool install wilfie

Or with pip:

pip install wilfie

Quickstart

wilfie auth login --client-id wilfie-cli

Check auth status:

wilfie auth status

List workspaces:

wilfie workspaces list

Run a WMS query:

wilfie wms query \
  --workspace <workspace_code> \
  --path facility-locations/search \
  --param query=A-01 \
  --param limit=25

Inspect fulfillment document lineage:

wilfie wms documents lineage \
  --workspace <workspace_code> \
  --kind fulfillment_order \
  --document-id <fulfillment_order_id> \
  --line-id <line_id> \
  --max-depth 8

Resolve a barcode and inspect tote outbound context:

wilfie wms barcodes resolve \
  --workspace <workspace_code> \
  --facility-id <facility_id> \
  --barcode <scan_value>

wilfie wms containers outbound-context \
  --workspace <workspace_code> \
  --container-id <container_id>

Run Shopify outbound reconcile (manual trigger):

wilfie wms reconcile outbound \
  --workspace <workspace_code> \
  --integration-connection-id <integration_connection_id> \
  --order-id gid://shopify/Order/123 \
  --dry-run

Analyze live-selling performance after ignoring orders less than $8:

wilfie --output json live-selling orders \
  --workspace <workspace_code> \
  --period this_month \
  --order-total-less-than 8

Download order-level live-selling data for local analysis:

wilfie live-selling orders \
  --workspace <workspace_code> \
  --period this_month \
  --order-total-less-than 8 \
  --download-file live-selling-orders.csv

List open WMS issues for a facility:

wilfie wms issues list \
  --workspace <workspace_code> \
  --facility-id <facility_id> \
  --status open

Recompute WMS issues for a facility (admin/owner access required):

wilfie wms issues recompute \
  --workspace <workspace_code> \
  --facility-id <facility_id> \
  --dry-run

Platform administrators can discover and preview reusable workspace maintenance operations:

wilfie admin operations list --workspace <workspace_code>
wilfie admin operations describe backfill_integration_dead_letter_issues \
  --workspace <workspace_code>
wilfie admin operations run backfill_integration_dead_letter_issues \
  --workspace <workspace_code> \
  --set integration_connection_id=<integration_connection_id>

Admin operations are OAuth-only and require both platform-admin and workspace-admin access. Runs default to server-enforced dry-run mode. Applying the reviewed scope requires both --apply and an audit reason:

wilfie admin operations run backfill_integration_dead_letter_issues \
  --workspace <workspace_code> \
  --set integration_connection_id=<integration_connection_id> \
  --apply \
  --reason "Backfill historical dead-letter issues after release"

The dead-letter operation creates missing operational issues only. It never replays integration events.

Supplier Offer Recovery

Use these commands in order to restore PIM details from the stored Shopify mirror, fill missing offer catalog fields, and reapply the offer's pricing:

wilfie supplier-offers update-pim --workspace <workspace_code> --offer-id <offer_id>
wilfie supplier-offers hydrate --workspace <workspace_code> --offer-id <offer_id>
wilfie supplier-offers promote-pricing --workspace <workspace_code> --offer-id <offer_id>

Update PIM also copies mirror prices into PIM, so run Pricing Only last. Hydrate preserves offer pricing and supports --dry-run; its default mode fills blanks. Pricing Only requests pricing updates without publishing catalog fields or inventory. The queued commands wait for completion unless --no-wait is supplied. Review the returned warnings and per-product results for skipped or failed updates. All three commands require OAuth login. Update PIM and Hydrate require workspace admin access; Pricing Only requires editor access.

Common Commands

wilfie auth login
wilfie auth refresh
wilfie auth logout
wilfie workflows list --workspace <workspace_code>
wilfie workflows runs --workspace <workspace_code> --workflow-id <id>
wilfie workflows run-detail --workspace <workspace_code> --workflow-id <id> --run-id <id>
wilfie workflows execute --workspace <workspace_code> --workflow-id <id>
wilfie live-selling orders --workspace <workspace_code> --period this_month --order-total-less-than 8
wilfie wms facilities --workspace <workspace_code>
wilfie wms skus --workspace <workspace_code>
wilfie wms documents list --workspace <workspace_code> --kind sales_order [--search-query <query>]
wilfie wms documents list --workspace <workspace_code> --kind fulfillment_order
wilfie wms documents detail --workspace <workspace_code> --kind fulfillment_order --document-id <id>
wilfie wms documents lineage --workspace <workspace_code> --kind fulfillment_order --document-id <id> --line-id <id>
wilfie wms barcodes resolve --workspace <workspace_code> --facility-id <facility_id> --barcode <scan_value>
wilfie wms containers outbound-context --workspace <workspace_code> --container-id <container_id>
wilfie wms issues list --workspace <workspace_code> [--facility-id <facility_id>] [--status <open|ignored|resolved>]
wilfie wms issues recompute --workspace <workspace_code> [--facility-id <facility_id>] [--scope <scope>] [--dry-run]
wilfie wms reconcile outbound --workspace <workspace_code> --integration-connection-id <id> [--order-id <shopify_order_id>] [--fulfillment-order-id <shopify_fo_id>] [--dry-run]
wilfie admin operations list --workspace <workspace_code>
wilfie admin operations describe <operation_key> --workspace <workspace_code>
wilfie admin operations run <operation_key> --workspace <workspace_code> [--set key=value] [--apply --reason <reason>]

Configuration

Default API host is https://wilfie.ai.
Use --base-url to target another environment.
Output modes: --output table (default), --output json.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wilfie-2026.9.8.2.tar.gz (71.0 kB view details)

Uploaded Sep 8, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

wilfie-2026.9.8.2-py3-none-any.whl (70.4 kB view details)

Uploaded Sep 8, 2026 Python 3

File details

Details for the file wilfie-2026.9.8.2.tar.gz.

File metadata

Download URL: wilfie-2026.9.8.2.tar.gz
Upload date: Sep 8, 2026
Size: 71.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for wilfie-2026.9.8.2.tar.gz
Algorithm	Hash digest
SHA256	`d08426d48d82766473f4a350c0c6781ec6d763f0a11384f0fca0926085ffac3e`
MD5	`387e79080a393d394dbbebfae0ac89de`
BLAKE2b-256	`a54796e6266fcf6fe2090acfe8e2c374c7aa712cdacb67df251e74884ba6c38e`

See more details on using hashes here.

File details

Details for the file wilfie-2026.9.8.2-py3-none-any.whl.

File metadata

Download URL: wilfie-2026.9.8.2-py3-none-any.whl
Upload date: Sep 8, 2026
Size: 70.4 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for wilfie-2026.9.8.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`bd6c665eee1197913d7763c5dcb380faeefa41f1a7c21c9a098ea502933b4bd5`
MD5	`6e729d302585520756eee3d19f0cff88`
BLAKE2b-256	`92a9077d9a742b7bfdabc64918726ed7f50b4b44486be87705217bbc55b184dd`