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.jsonin 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: code, message, fix, file. With --json the same object is the last line.