CLI Reference
Deploy, manage, and monitor your apps from the terminal.
Authentication
promptship login
Opens a browser for Google OAuth. Your session is stored locally.
promptship logout
Remove stored credentials.
Commands
Apps
| Command | Description |
|---|
promptship apps list | List all apps in your team |
promptship apps create <name> --repo <url> | Create a new app |
promptship apps info <name> | Show app details and environments |
promptship apps config <name> | Show build config |
promptship apps configure <name> --root <dir> --health <path> | Configure build settings |
promptship apps delete <name> | Delete an app and all its resources |
promptship apps attach-postgres <name> --env <env> | Attach a Postgres database |
promptship apps detach-postgres <name> --env <env> | Detach Postgres (data retained 7 days) |
promptship apps attach-valkey <name> --env <env> | Attach a Valkey (Redis) cache |
promptship apps detach-valkey <name> --env <env> | Detach Valkey (data retained 7 days) |
Deploys
| Command | Description |
|---|
promptship deploy --app <name> --branch <branch> | Deploy from a branch (default: main, env: dev) |
promptship deploy --app <name> --env prod | Deploy to production |
promptship status --app <name> | Show latest deploy status |
promptship logs --app <name> | View app logs |
promptship rollback --app <name> | Rollback to previous deploy |
Secrets
| Command | Description |
|---|
promptship secrets set KEY=VALUE --app <name> | Set a secret (encrypted at rest) |
promptship secrets list --app <name> | List secret keys (values hidden) |
promptship secrets delete <KEY> --app <name> | Delete a secret |
Domains
| Command | Description |
|---|
promptship domains set <domain> --app <name> | Set a custom domain |
promptship domains verify --app <name> | Check if domain DNS is verified |
promptship domains remove --app <name> | Remove custom domain |
Teams
| Command | Description |
|---|
promptship teams list | List your teams |
promptship teams create <name> | Create a new team |
Tokens
| Command | Description |
|---|
promptship tokens create <name> | Create an API token |
promptship tokens list | List API tokens |
promptship tokens delete <token-id> | Delete an API token |
GitHub
| Command | Description |
|---|
promptship github install | Install GitHub App on your account |
promptship github repos | List accessible repositories |
Tip: Most commands that operate on an app accept --env (default: dev) and --team-id options.
