# Command reference

> Every command the CLI has, 24 in all, with its arguments, flags and examples.

Source: https://storeware.ai/docs/cli/commands

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`](https://storeware.ai/docs/cli/commands/login) | Sign in by approving a code in the admin. |
| [`logout`](https://storeware.ai/docs/cli/commands/logout) | End this sign-in, on the server as well as here. |
| [`whoami`](https://storeware.ai/docs/cli/commands/whoami) | Show who you are, in which organisation, and your apps. |

## Building an app

| Command | What it does |
| --- | --- |
| [`init`](https://storeware.ai/docs/cli/commands/init) | Scaffold an app, with a manifest and a server to start from. |
| [`validate`](https://storeware.ai/docs/cli/commands/validate) | Check a manifest, and its scopes and events when you are signed in. |
| [`app dev`](https://storeware.ai/docs/cli/commands/app-dev) | Run your app on a development store, through a tunnel to this machine. |
| [`app preflight`](https://storeware.ai/docs/cli/commands/app-preflight) | Run the checks a review runs, against your app on a development store. |
| [`app submit`](https://storeware.ai/docs/cli/commands/app-submit) | Send your app's listing draft for review. |
| [`mcp`](https://storeware.ai/docs/cli/commands/mcp) | Serve the docs, the manifest schema and your app to a coding agent, over MCP on stdio. |
| [`app deploy`](https://storeware.ai/docs/cli/commands/app-deploy) | Send a production release, with a hosted app’s code bundled and uploaded first, and say which shops take it. |
| [`app releases`](https://storeware.ai/docs/cli/commands/app-releases) | List releases, newest first, with how many shops run each. |
| [`app rollback`](https://storeware.ai/docs/cli/commands/app-rollback) | Make an earlier production release the current one again. |
| [`app logs`](https://storeware.ai/docs/cli/commands/app-logs) | Show the API calls your app made, newest last. |
| [`webhook trigger`](https://storeware.ai/docs/cli/commands/webhook-trigger) | Send your app one signed event from a development store. |

## Development stores

| Command | What it does |
| --- | --- |
| [`store list`](https://storeware.ai/docs/cli/commands/store-list) | List your development stores. |
| [`store create`](https://storeware.ai/docs/cli/commands/store-create) | Make a store that never opens and takes test payments only. |
| [`store seed`](https://storeware.ai/docs/cli/commands/store-seed) | Fill a development store with sample products and customers. |
| [`store test-order`](https://storeware.ai/docs/cli/commands/store-test-order) | Place a real order, so your app gets real order events. |

## Themes

| Command | What it does |
| --- | --- |
| [`theme init`](https://storeware.ai/docs/cli/commands/theme-init) | Scaffold a theme, offline. |
| [`theme validate`](https://storeware.ai/docs/cli/commands/theme-validate) | Read a theme file with the platform's own parsers, offline. |
| [`theme pull`](https://storeware.ai/docs/cli/commands/theme-pull) | Write this shop's published look to a file. |
| [`theme push`](https://storeware.ai/docs/cli/commands/theme-push) | Send a theme file to the draft, which shoppers do not see. |
| [`theme preview`](https://storeware.ai/docs/cli/commands/theme-preview) | Print a link that serves the draft, retiring the last one. |
| [`theme publish`](https://storeware.ai/docs/cli/commands/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. |