CLI overview

The Aly CLI (aly-store-cli) is a thin client over the same surface as MCP — sites, products, orders, customers, webhooks. It's designed for scripts, CI jobs, and humans who'd rather type than click.

At a glance

Two transports

• MCP mode (default) — POSTs JSON-RPC to /api/mcp. Identical semantics to Claude Desktop and Cursor. Use when you want a single audit trail across human, agent, and CLI.
• Direct mode (--direct) — talks to Convex and Next.js API routes directly. Faster on big iteration loops and easier to script. Recommended for CI.

1# Both forms work:2aly-store-cli sites list3aly-store-cli --direct sites list

Quick taste

1# List sites in the workspace2aly-store-cli sites list3 4# Show a single product as JSON5aly-store-cli products get prod_abc --json6 7# Add stock to a variant8aly-store-cli variants update var_1 --stock 509 10# Mark an order shipped11aly-store-cli orders fulfill ord_72...4b \12  --carrier USPS \13  --tracking 940011120255558284613714 15# List recent unfulfilled orders16aly-store-cli orders list --status pending --limit 25 --json

Sensitive arg redaction

The CLI never echoes secrets to stdout or your shell history file. Any flag matching --api-key, --token, --secret, --password, or --client-secret is replaced with *** in the meta output. Pass them via env vars when running in CI.

Next steps

• Install + sign in — get the CLI on your machine and pointed at a workspace.
• Sites + products — CRUD content from the terminal.
• Orders + fulfillment — operate the post-purchase pipeline.
• Webhooks + replay — register endpoints, replay deliveries.
• Scripting + CI — patterns for non-interactive use.