Reference
Commands
Browse the commands and options shipped with finoctl 0.3.0.
Each entry is generated from finoctl 0.3.0. Run a command with --help to see the options in your installed version.
The everyday sign-in flow uses finoctl wholesale login --browser. See Browser sign-in.
Global options
Usage: finoctl [options] [command]
Gallo Fino inventory MCP and authenticated wholesale website CLI. Website writes
require a reviewed preview.
Options:
-V, --version output the version number
--json stable JSON output (also the default)
--live owner-approved read-only production access
through existing Wrangler auth
--fixture explicit synthetic offline data; never
production evidence
-h, --help display help for command
Commands:
wholesale Wholesale admin: login, orders, products,
images, inventory, collections and
diagnostics
doctor Offline inventory/MCP setup check; use
wholesale status for website auth
tools Discover capabilities, read-only tools and
inventory sources
inventory Inspect one explicit stock source: catalog,
fulfillment or supplies
tool-call [options] <operation> Call one allowlisted tool with JSON; not a
SQL or HTTP escape hatch
mcp Run local stdio MCP; no network listener and
no protocol logs on stdout
help [command] display help for commandAccount
finoctl wholesale login
Usage: finoctl wholesale login [options]
Sign in normally, or use --browser for QR approval on your phone
Options:
--browser Scan a QR code and approve this CLI on the website
--name <label> Name shown when approving this CLI
--preview <version-prefix> Operator-only: approved eight-character Portal
preview version
-h, --help display help for commandfinoctl wholesale status
Usage: finoctl wholesale status|doctor [options]
Verify saved session against the website; no password output
Options:
-h, --help display help for commandfinoctl wholesale logout
Usage: finoctl wholesale logout [options]
Revoke this CLI session and remove its saved credentials
Options:
-h, --help display help for commandOrders
finoctl wholesale orders options
Usage: finoctl wholesale orders options [options]
Find buyer IDs, or read one buyer and checkout policy
Options:
--query <text> Buyer search (default: "")
--buyer <id> Exact account ID
--limit <n> Maximum buyers, 1–100 (default: "25")
-h, --help display help for commandfinoctl wholesale orders list
Usage: finoctl wholesale orders list [options]
Options:
--limit <n> Page size, 1–100 (default: "25")
--cursor <cursor> Continuation from last page (default: "")
-h, --help display help for commandfinoctl wholesale orders get
Usage: finoctl wholesale orders get [options] <id>
Read the exact saved order ID, not a guessed display number
Options:
-h, --help display help for commandfinoctl wholesale orders create
Usage: finoctl wholesale orders create [options]
Get a shipping-only server quote and save a preview; apply requires explicit
order/reservation/PDF acknowledgment
Options:
--file <path> Shipping-only order JSON; server enforces buyer, MOQ, prices
and capacity
--out <path> Private preview file, mode 0600
-h, --help display help for commandProducts and images
finoctl wholesale products list
Usage: finoctl wholesale products list [options]
Options:
--query <text> Name or SKU search (default: "")
--page <n> Zero-based page; 25 products/page (default: "0")
-h, --help display help for commandfinoctl wholesale products resolve
Usage: finoctl wholesale products resolve [options] <query>
Search names; use an exact SKU for subsequent commands
Options:
-h, --help display help for commandfinoctl wholesale products get
Usage: finoctl wholesale products get [options] <sku>
Read an exact product and its saved revision
Options:
-h, --help display help for commandfinoctl wholesale products create
Usage: finoctl wholesale products create [options]
Preview a new wholesale product; manage listing separately in the dashboard
Options:
--file <path> Product JSON (see README)
--out <path> New preview file
-h, --help display help for commandfinoctl wholesale products update
Usage: finoctl wholesale products update [options] <sku>
Preview partial edits from JSON: description, prices, availability, customs
fields and more
Options:
--file <path> Partial product JSON
--out <path> New preview file
-h, --help display help for commandfinoctl wholesale products archive
Usage: finoctl wholesale products archive [options] <sku>
Preview product archive
Options:
--out <path> New preview file
-h, --help display help for commandfinoctl wholesale products restore
Usage: finoctl wholesale products restore [options] <sku>
Preview product restore
Options:
--out <path> New preview file
-h, --help display help for commandfinoctl wholesale products delete
Usage: finoctl wholesale products delete [options] <sku>
Preview removal from active views; retains SKU and order history, no physical
erase
Options:
--out <path> New preview file
-h, --help display help for commandfinoctl wholesale products images list
Usage: finoctl wholesale products images list [options] <sku>
Options:
-h, --help display help for commandfinoctl wholesale products images upload
Usage: finoctl wholesale products images upload|add [options] <sku> <file>
Preview a PNG/JPEG/WebP upload and append; bytes checked again at apply
Options:
--out <path> New preview file
-h, --help display help for commandfinoctl wholesale products images reorder
Usage: finoctl wholesale products images reorder [options] <sku>
Preview exact gallery order, using a JSON array of saved image keys
Options:
--file <path> JSON array containing every current image key once
--out <path> New preview file
-h, --help display help for commandfinoctl wholesale products images remove
Usage: finoctl wholesale products images remove [options] <sku> <photo-key>
Preview removal of one exact saved image; never guess by position
Options:
--out <path> New preview file
-h, --help display help for commandStock and collections
finoctl wholesale inventory set
Usage: finoctl wholesale inventory set [options] <sku> <quantity>
Preview an exact count with quantity tracking enabled; does not write production
Options:
--out <path> New preview JSON file (will not overwrite)
-h, --help display help for commandfinoctl wholesale inventory add
Usage: finoctl wholesale inventory add [options] <sku> <quantity>
Preview a catalog count addition, revision-fenced; not a warehouse receipt
Options:
--out <path> New preview file
-h, --help display help for commandfinoctl wholesale collections list
Usage: finoctl wholesale collections list [options]
Options:
-h, --help display help for commandfinoctl wholesale collections assign
Usage: finoctl wholesale collections assign [options] <name> <skus...>
Preview bulk assignment; use an empty name to remove the collection
Options:
--out <path> New preview JSON file
-h, --help display help for commandDiagnostics
finoctl wholesale diagnostics summary
Usage: finoctl wholesale diagnostics summary [options]
Stored error totals; unavailable data never becomes a false zero
Options:
--hours <n> Look back 1–168 hours (default: "24")
-h, --help display help for commandfinoctl wholesale diagnostics list
Usage: finoctl wholesale diagnostics list [options]
Bounded recent reports; repeated event IDs are grouped
Options:
--hours <n> Look back 1–720 hours (default: "24")
--limit <n> Newest 1–100 stored rows, no cursor (default: "25")
--source <source> web, ios-verify, ios-admin, android-verify, control-api,
verify-worker, portal, telemetry
--severity <level> error, warn or info; omitted includes all
-h, --help display help for commandfinoctl wholesale diagnostics find
Usage: finoctl wholesale diagnostics find [options] <reference>
Look up an exact event, request or diagnostic reference
Options:
--hours <n> Look back 1–720 hours (default: "24")
--limit <n> Newest 1–100 stored rows, no cursor (default: "25")
--source <source> web, ios-verify, ios-admin, android-verify, control-api,
verify-worker, portal, telemetry
--severity <level> error, warn or info; omitted includes all
-h, --help display help for commandApply and request
finoctl wholesale apply
Usage: finoctl wholesale apply [options] <file>
Apply one reviewed preview; preserve the file and operation ID for any retry
Options:
--confirm <checksum> Confirm the exact preview checksum printed during
preparation
--accept-order-effects Explicitly accept order obligation/reservation and
invoice/PDF generation
-h, --help display help for commandfinoctl wholesale request
Usage: finoctl wholesale request [options] <path>
Read-only escape hatch: /api/me, /api/admin/products or /api/admin/drops only
Options:
-h, --help display help for commandInventory and MCP
finoctl inventory summary
Usage: finoctl inventory summary [options]
Options:
--source <source> catalog | fulfillment | supplies
-h, --help display help for commandfinoctl inventory list
Usage: finoctl inventory list [options]
Options:
--source <source> catalog | fulfillment | supplies
--limit <number> page size 1–100 (default: "25")
--offset <number> bounded offset 0–10000 (default: "0")
--query <text> literal name or ID search (default: "")
-h, --help display help for commandfinoctl inventory resolve
Usage: finoctl inventory resolve [options] <name>
Resolve a name to an exact stock identity; can return multiple matches
Options:
--source <source> catalog | fulfillment | supplies
--limit <number> page size 1–100 (default: "25")
--offset <number> bounded offset 0–10000 (default: "0")
-h, --help display help for commandfinoctl inventory get
Usage: finoctl inventory get [options] <id>
Options:
--source <source> catalog | fulfillment | supplies
--limit <number> page size 1–100 (default: "25")
--offset <number> bounded offset 0–10000 (default: "0")
-h, --help display help for commandfinoctl inventory history
Usage: finoctl inventory history [options] <id>
Options:
--source <source> catalog | fulfillment | supplies
--limit <number> page size 1–100 (default: "25")
--offset <number> bounded offset 0–10000 (default: "0")
-h, --help display help for commandfinoctl doctor
Usage: finoctl doctor [options]
Offline inventory/MCP setup check; use wholesale status for website auth
Options:
-h, --help display help for commandfinoctl tools
Usage: finoctl tools [options]
Discover capabilities, read-only tools and inventory sources
Options:
-h, --help display help for commandfinoctl tool-call
Usage: finoctl tool-call [options] <operation>
Call one allowlisted tool with JSON; not a SQL or HTTP escape hatch
Options:
--args <json> tool arguments (default: "{}")
-h, --help display help for commandfinoctl mcp
Usage: finoctl mcp [options]
Run local stdio MCP; no network listener and no protocol logs on stdout
Options:
-h, --help display help for command