# Command reference

Every uarpie command. Your AI runs these; you can too.

Run any of them with `npx uarpie <command>`. Nothing to install.

| Command | What it does |
|---|---|
| `uarpie` or `uarpie deploy` | Detect, build and put the app in the current folder online |
| `uarpie status` | Where the app is, which version is live, spend this month |
| `uarpie logs` | Recent activity from the app |
| `uarpie versions` | Every version, newest first |
| `uarpie rollback` | Go back to the previous version (code only unless `--with-data`) |
| `uarpie login` | Sign this computer into your account (approve a code in the browser) |
| `uarpie logout` | Forget the account on this computer |
| `uarpie whoami` | Which account this computer is signed in as |
| `uarpie projects` | List the apps in your account |
| `uarpie clone <app> [dir]` | Put an app's source on this computer |
| `uarpie mcp` | Run the MCP server over stdio for an AI agent |

## Options

| Option | Meaning |
|---|---|
| `--json` | One JSON object per line, for agents |
| `-C <dir>` | Act on a different folder |
| `deploy -y` | Never prompt; skip missing secrets |
| `deploy --dry-run` | Detect and write `deploy.json`, deploy nothing |
| `deploy -e KEY=value` | Set a secret for this deploy |
| `rollback --to <id>` | A specific version instead of the previous one |
| `rollback --with-data` | Also restore the database snapshot from before that version |
| `clone --version <n>` | A specific version instead of the live one |
| `mcp --client <name>` | The agent's name, shown in version history |
| `-p <id-or-name>` | Name the app when not in its folder (`status`, `logs`, `versions`, `rollback`) |

## Where things are stored

- `deploy.json` in the app's folder: the plan. Safe to commit, contains no secrets.
- Your credentials: outside the project, in your user config folder. Never in the app.
- Secrets: on the platform only.

## Exit codes and errors

`0` on success, `1` on failure. Every failure is printed as the [error contract](/docs/errors): code, message, fix, file. With `--json` the same object is the last line.