shopi-cli

Authentication, credentials, scopes, and profiles for the shopi CLI (`shopi`). Use this whenever you need to authenticate, log in to a store, set up credentials, pick or switch which store/profile shopi talks to, run shopi in CI with env-only auth, or debug auth problems — "token not working", "401 / 403", "Access denied", "shop_not_permitted", "no profile configured", "which profile is active", "switch stores", "wrong API version", or "where does shopi store my token". Covers `shopi auth login|status|doctor|profiles| logout`, `shopi init`, the env-var precedence (client credentials vs access token vs saved profile), shop normalization, token redaction, config file locations, and scope failures. Complements the hub skill `shopi-cli-usage` — load that for general command/output mechanics; load this for everything about getting and keeping shopi authenticated.

Run Shopify Admin **bulk operations** with the shopi CLI (`shopi`) to export or import data at scale instead of paginating. Use this skill whenever the user wants to export all products / all orders / all customers, dump the whole catalog, pull a large dataset to a file, bulk update or bulk tag thousands of records, mass-import products or metafields, run a large data job, get a JSONL export, or says paginating `shopi read` is "too slow" / "too many to page through" / "there are way too many records" — even if they don't say "bulk operation" or "JSONL". Covers bulkOperationRunQuery (export), bulkOperationRunMutation (import), stagedUploadsCreate, polling via bulkOperations/currentBulkOperation, bulkOperationCancel, JSONL shape (`__parentId`), and the bulk_operations/finish webhook. Complements the `shopi-cli-usage` hub skill — load that first for global flags, output, GIDs, pagination, and write safety.

Core guidance for using the shopi CLI (`shopi`), a JSON-first, schema-driven command line over the Shopify Admin GraphQL API. Covers discovery (ops/schema), reading (`shopi read`), writing (`shopi write`), exact GraphQL (`shopi gql`), flags, output formats, GIDs, pagination, and write safety. Use this skill whenever the user wants to run, design, script, or debug `shopi` commands, or to inspect or change a Shopify store from the command line via the Admin API — including products, orders, customers, inventory, metafields, discounts, and any other Admin resource — even when they don't say "shopi" or "GraphQL" explicitly. This is the hub skill; for a specific domain, also load the matching shopi-* skill (auth, products, orders, customers, inventory, metafields, discounts, bulk-operations).

Customer, segment, and B2B operations with the shopi CLI (`shopi`) over the Shopify Admin GraphQL API. Use whenever the user wants to find customers by email/tag/state/country, look up top spenders or high-order customers, create/update/delete a customer, add or remove customer tags, edit a customer's addresses, set email or SMS marketing consent, work with customer segments (list/create/update/delete and read members), or manage B2B companies, company contacts, and company locations — even when they don't say "shopi" or "GraphQL". Complements the hub skill `shopi-cli-usage` (global flags, discovery, output, GIDs, write safety) and defers to `shopi-bulk-operations` for large customer exports.

Discount and pricing operations with the shopi CLI (`shopi`) over the Shopify Admin GraphQL API. Use whenever the user wants to create a discount code, percentage off or amount off, buy one get one (BXGY), a free shipping discount, an automatic discount, bulk-generate redeem codes, read or list existing discounts and their usage, activate/deactivate/delete a discount, or set up a B2B price list or market pricing — even when they don't say "shopi" or "GraphQL". Triggers on "create a discount code", "percentage off", "buy one get one", "free shipping discount", "automatic discount", "deactivate a discount", "bulk discount codes", "B2B price list", "market pricing". Complements the hub skill `shopi-cli-usage` (global flags, discovery, output, write safety); the CLI itself is fully specified there.

Inventory and location operations with the shopi CLI (`shopi`) over the Shopify Admin GraphQL API. Use whenever the user wants to set a stock level, adjust inventory, check a quantity at a location, move stock between locations, fix an out-of-stock or oversold item, run an inventory reconciliation, update a variant's cost or tracking, activate/deactivate inventory at a location, or list/manage locations — even when they don't say "shopi" or "GraphQL". Triggers on "set stock level", "adjust inventory", "check quantity at a location", "move stock between locations", "out of stock", "inventory reconciliation", "update cost", "is this tracked", "activate location". Complements the hub skill `shopi-cli-usage` (global flags, discovery, output, write safety) and defers to `shopi-bulk-operations` for store-wide reconciliation.

Read, set, and model Shopify custom data with the shopi CLI (`shopi`) over the Admin GraphQL API. Use this skill whenever the user wants to set a metafield, read metafields, store custom data on a product (or variant, customer, order, collection, shop, etc.), work with custom fields, create or list metafield definitions, or model and reference metaobjects — even if they don't say "metafield", "metaobject", or "GraphQL". Covers metafieldsSet, metafieldsDelete, metafield/metafieldDefinition queries, metafieldDefinitionCreate/Update/Delete, metaobjectDefinitionCreate, metaobjects queries, and metaobjectCreate/Update/Upsert/Delete. Complements the `shopi-cli-usage` hub skill — load that first for global flags, output formats, GIDs, pagination, and write safety.

Order and fulfillment operations with the shopi CLI (`shopi`) over the Shopify Admin GraphQL API. Use whenever the user wants to list paid orders, find unfulfilled orders, look up or update an order, fulfill an order or add tracking, hold/release/move a fulfillment order, cancel, close, capture, or mark an order as paid, tag orders, create or complete a draft order, or process a return or refund — even when they don't say "shopi" or "GraphQL". Triggers on "list paid orders", "unfulfilled orders", "fulfill an order", "add tracking", "cancel/refund an order", "create a draft order", "process a return". Complements the hub skill `shopi-cli-usage` (global flags, discovery, output, write safety) and defers to `shopi-bulk-operations` for large order exports.

Catalog operations with the shopi CLI (`shopi`) over the Shopify Admin GraphQL API: reading and searching products, variants, and collections, and writing them. Use whenever the user wants to create a product, update or bulk-update variants (price, SKU, inventory policy), change a product's status (ACTIVE/DRAFT/ARCHIVED), find products by tag/vendor/type/status, add or reorder products in a collection, create or update a collection, attach product media, or publish/unpublish a product to a sales channel (Online Store, POS) — even when they don't say "shopi" or "GraphQL". Complements the hub skill `shopi-cli-usage` (global flags, discovery, output, write safety) and defers to `shopi-bulk-operations` for very large catalogs.