# appkeep CLI reference

Run it with `npx appkeep@latest <command>` (or `npm i -D appkeep@latest`). Versions before 0.3.0 ignore the
`build` block and don't upload store screenshots; `appkeep check` warns about them. `appkeep help <command>` prints
the options of one command and `appkeep --version` the version.

| Command | What it does |
|---|---|
| `create <dir> [--name "My App"]` | Starts an app from the template (Hono, env.DB, altstack.json, AGENTS.md, SECURITY-REVIEW.md) |
| `dev [dir]` | Runs the app on localhost in the real Workers runtime, signed in as the owner. No account needed. `--port`, `--open`, `--reset` (wipe local data), `--frontend <url>` and `--run "<cmd>"` (Vite with hot reload), `--prebuilt <module.js> --assets <dir>` |
| `login [--url https://appkeep.io]` | Opens the browser to approve the CLI and saves the token in `~/.altstack/config.json`. `--email … --password … [--signup]` for CI |
| `whoami` | The account and server that check, publish and push use |
| `logout` | Deletes the saved token |
| `check [dir]` | Builds the app and runs the automated review. Nothing is submitted |
| `publish [dir]` | Builds, uploads static files, store media and source, and submits the version for review. Bump `version` first |
| `pack [dir] [--out file]` | Writes the package publish would send, to inspect it |
| `push <address> [dir] -m "…"` | For buyers: runs a changed copy of an app they bought on their own deployment (Plus and up) |

check, pack, publish and push run the `build` block's `command` first; `--no-build` skips it, and `--prebuilt` /
`--assets` override its paths. Every upload starts by printing the account it goes to.
