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> --app-type <type> --root <dir> --android-package <pkg>`	Configure build settings (`app-type`: web, android)
`promptship apps delete <name>`	Delete an app and all its resources
`promptship apps attach-postgres <name> --env <env> [--version 17]`	Attach a Postgres database. Runs async in a worker; CLI polls until the attach finishes or fails.
`promptship apps detach-postgres <name> --env <env>`	Detach Postgres
`promptship apps attach-valkey <name> --env <env> [--version 8]`	Attach a Valkey (Redis-compatible) cache. Runs async in a worker; CLI polls until the attach finishes or fails.
`promptship apps detach-valkey <name> --env <env>`	Detach Valkey
`promptship apps attach-clickhouse <name> --env <env> [--version 24.8]`	Attach a ClickHouse analytics database. Runs async in a worker; CLI polls until the attach finishes or fails (ClickHouse can take a few minutes). Injects `CLICKHOUSE_URL` (HTTP, 8123) and `CLICKHOUSE_NATIVE_URL` (native, 9000) on next deploy.
`promptship apps detach-clickhouse <name> --env <env>`	Detach ClickHouse
`promptship apps change-tier <name> <env> --tier <tier>`	Change compute tier (app-1 … app-5)
`promptship apps change-postgres-tier <name> <env> --tier <tier>`	Change Postgres tier (pg-1, pg-2 …). Storage can't shrink; pod rolls with new resources.
`promptship apps change-valkey-tier <name> <env> --tier <tier>`	Change Valkey tier (valkey-1 …). Storage can't shrink; pod rolls with new resources.
`promptship apps change-clickhouse-tier <name> <env> --tier <tier>`	Change ClickHouse tier (ch-1 … ch-5). Storage can't shrink; pod rolls with new resources.
`promptship apps reapply-db-tier <name> <env> --db-type <postgres\|valkey\|clickhouse>`	Reconcile the running pod to the stored tier. Idempotent; run after a partial failure.
`promptship apps query-postgres <name> --env <env> --sql <query>`	Run a SQL query against the app's Postgres
`promptship apps reset-postgres <name> --env <env>`	Wipe the Postgres database (irreversible)
`promptship apps query-valkey <name> --env <env> --command <cmd>`	Run a Valkey/Redis command
`promptship apps reset-valkey <name> --env <env>`	Flush the Valkey cache (irreversible)
`promptship apps query-clickhouse <name> --env <env> --sql <query>`	Run a SQL query against the app's ClickHouse
`promptship apps reset-clickhouse <name> --env <env>`	Drop and recreate the ClickHouse database (irreversible)
`promptship apps download-keystore <name>`	Download Android signing keystore as .p12

Environments

Command	Description
`promptship env create <app> <env-name> --app-tier <tier>`	Add a new environment to an app
`promptship env delete <app> <env-name>`	Delete an environment and all its resources

Processes

Command	Description
`promptship process add <app> <name> --type <type>`	Add/update a process (`type`: web, worker, cron)
`promptship process remove <app> <name>`	Remove a process from an app

Deploys

Command	Description
`promptship deploy --app <name> --env <env> --branch <branch>`	Deploy from a branch
`promptship status --app <name> --env <env>`	Show latest deploy status
`promptship logs --app <name> --env <env>`	View app logs
`promptship rollback --app <name> --env <env>`	Rollback to previous deploy
`promptship ssh --app <name> --env <env> --process <process>`	Open an interactive shell in a running container (admin role required). Pass `--session-token` to reconnect to the same container.

Mobile

Command	Description
`promptship submit-app --app <name> --env <env> --branch <branch> --track <track>`	Build APK and submit to Google Play (`track`: internal, production)
`promptship submit-app-status --app <name>`	Show submission history

Secrets

Command	Description
`promptship secrets set KEY=VALUE --app <name> --env <env>`	Set a secret (encrypted at rest)
`promptship secrets list --app <name> --env <env>`	List secret keys (values hidden)
`promptship secrets delete <KEY> --app <name> --env <env>`	Delete a secret

Domains

Command	Description
`promptship domains set <domain> --app <name> --env <env>`	Set a custom domain
`promptship domains verify --app <name> --env <env>`	Check if domain DNS is verified
`promptship domains remove --app <name> --env <env>`	Remove custom domain

Teams

Command	Description
`promptship teams list`	List your teams
`promptship teams create <name>`	Create a new team
`promptship teams invite <email> --team-id <id>`	Invite a user to a team
`promptship teams remove <user-id> --team-id <id>`	Remove a member from a team
`promptship teams role <user-id> --team-id <id> --role <role>`	Update a member's role (member, admin)

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

Usage & Billing

Command	Description
`promptship usage team --team <team> [--start <iso>] [--end <iso>]`	Per-team usage breakdown for a date range (default: last 30 days). Shows compute, bandwidth, builds, projected cost.
`promptship usage summary --team <team> --month <YYYY-MM>`	Whole-month projected bill, including platform fee.
`promptship usage app <app-name> [--team <team>] [--start <iso>] [--end <iso>]`	Per-app usage breakdown for a date range.

GitHub

Command	Description
`promptship github install`	Install the PromptShip GitHub App on your account
`promptship github repos`	List accessible repositories
`promptship github disconnect --account <login>`	Disconnect a GitHub App installation

Tip: All commands accept --team-id to target a specific team. Add --json to any command for machine-readable output.