Deploy changes to cloud tenants.
Pre-Deploy Checklist
{ "command": "cloud auth whoami" }
{ "command": "admin session show" }
{ "command": "cloud tenant list" }
{ "command": "cloud status" }
If not authenticated, run just login in the terminal.
Switch profile if needed:
{ "command": "admin session switch <profile-name>" }
Deploy Commands
Full deploy (build + push + deploy) is a long-running operation -- use the terminal:
just deploy
Non-Interactive Mode (CI/CD or Agents)
In non-interactive mode (scripts, CI/CD, AI agents), you must provide explicit flags:
# Required flags for non-interactive deploy
systemprompt cloud deploy --profile <profile-name> --yes
# Skip pre-deploy sync (use when only deploying code changes, not runtime files)
systemprompt cloud deploy --profile <profile-name> --yes --no-sync
| Flag | Required | Description |
|---|---|---|
--profile <name> |
Yes | Target profile (e.g., systemprompt-prod) |
--yes |
Yes | Confirm destructive operation |
--no-sync |
No | Skip syncing runtime files from cloud before deploy |
--skip-push |
No | Skip Docker build/push (redeploy existing image) |
Via MCP
{ "command": "cloud deploy" }
{ "command": "cloud deploy --profile <profile-name> --yes" }
{ "command": "cloud deploy --profile <profile-name> --yes --no-sync" }
Post-Deploy Verification
{ "command": "cloud status" }
{ "command": "cloud db status --profile <profile-name>" }
{ "command": "cloud db query --profile <profile-name> \"SELECT COUNT(*) FROM users\"" }
Restart Cloud Tenant
{ "command": "cloud restart --yes" }
Troubleshooting
Not authenticated (Error: Cloud authentication required) -- run just login in the terminal.
No tenant (Error: No tenant configured):
{ "command": "cloud tenant list" }
{ "command": "cloud profile show" }
Cloud not responding after deploy -- check cloud status, then cloud restart --yes.
Quick Reference
| Task | Command |
|---|---|
| Login | just login (terminal) |
| Full deploy (interactive) | just deploy (terminal) |
| Full deploy (non-interactive) | cloud deploy --profile <name> --yes |
| Deploy without sync | cloud deploy --profile <name> --yes --no-sync |
| Skip rebuild | cloud deploy --profile <name> --yes --skip-push |
| Cloud status | cloud status |
| Restart cloud | cloud restart --yes |
| Cloud DB query | cloud db query --profile <name> "SQL" |