Command reference
Command reference
Every command the CLI has, 24 in all, with its arguments, flags and examples.
Each command runs as npx @storeware/cli <command>. The same text is in your terminal: run npx @storeware/cli help for this list, or add --help to any command for its page.
Signing in
| Command | What it does |
|---|---|
login | Sign in by approving a code in the admin. |
logout | End this sign-in, on the server as well as here. |
whoami | Show who you are, in which organisation, and your apps. |
Building an app
| Command | What it does |
|---|---|
init | Scaffold an app, with a manifest and a server to start from. |
validate | Check a manifest, and its scopes and events when you are signed in. |
app dev | Run your app on a development store, through a tunnel to this machine. |
app preflight | Run the checks a review runs, against your app on a development store. |
app submit | Send your app's listing draft for review. |
mcp | Serve the docs, the manifest schema and your app to a coding agent, over MCP on stdio. |
app deploy | Send a production release, with a hosted app’s code bundled and uploaded first, and say which shops take it. |
app releases | List releases, newest first, with how many shops run each. |
app rollback | Make an earlier production release the current one again. |
app logs | Show the API calls your app made, newest last. |
webhook trigger | Send your app one signed event from a development store. |
Development stores
| Command | What it does |
|---|---|
store list | List your development stores. |
store create | Make a store that never opens and takes test payments only. |
store seed | Fill a development store with sample products and customers. |
store test-order | Place a real order, so your app gets real order events. |
Themes
| Command | What it does |
|---|---|
theme init | Scaffold a theme, offline. |
theme validate | Read a theme file with the platform's own parsers, offline. |
theme pull | Write this shop's published look to a file. |
theme push | Send a theme file to the draft, which shoppers do not see. |
theme preview | Print a link that serves the draft, retiring the last one. |
theme publish | Make the draft the shop, the one theme command a shopper sees. |
Flags every command takes
| Flag | What it does |
|---|---|
--api <url> | Use another API, for local development. |
--admin <url> | Use another admin, for local development. |
--help | Show the command's help instead of running it. |