Temps CLI Reference
Auto-generated documentation for the Temps CLI.
Generated on: 2026-02-18
Installation
# Or use with bunx
bunx @temps-sdk/cli [command]
Authentication
Before using most commands, you need to authenticate:
# Login with API key
bunx @temps-sdk/cli login
# Or configure with wizard
bunx @temps-sdk/cli configure
Global Options
| Flag | Description |
|---|---|
-v, --version | Display version number |
--no-color | Disable colored output |
--debug | Enable debug output |
-h, --help | Display help for command |
Commands
login
Authenticate with the current Temps instance
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-k, --api-key <key> | API key (will prompt if not provided) | - | Yes |
--email [email] | Login with email and password | - | No |
--magic [email] | Login via magic link (email-based) | - | No |
logout
Log out and clear credentials
whoami
Display current authenticated user
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output as JSON | - | No |
configure
Configure CLI settings (AWS-style wizard)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--api-url <url> | API URL | - | Yes |
--api-token <token> | API token for authentication | - | Yes |
--output-format <format> | Output format (table, json, minimal) | - | Yes |
--enable-colors | Enable colored output in config | - | No |
--disable-colors | Disable colored output in config | - | No |
-i, --interactive | Force interactive mode even in non-TTY | - | No |
-y, --no-interactive | Non-interactive mode (uses defaults for unspecified options) | - | No |
Subcommands:
get- Get a configuration valueset- Set a configuration valuelist- List all configuration valuesshow- Show current configuration and authentication statusreset- Reset configuration to defaults
configure get
Get a configuration value
configure set
Set a configuration value
configure list
List all configuration values
configure show
Show current configuration and authentication status
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
configure reset
Reset configuration to defaults
projects (alias: project, p)
Manage projects
Subcommands:
list(ls) - List all projectscreate(new) - Create a new projectshow(get) - Show project detailsupdate(edit) - Update project name and descriptionsettings- Update project settings (slug, attack mode, preview environments)git- Update git repository settingsconfig- Update deployment configuration (resources, replicas)delete(rm) - Delete a project
projects list (alias: ls)
List all projects
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
--page <n> | Page number | - | Yes |
--per-page <n> | Items per page | - | Yes |
projects create (alias: new)
Create a new project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-n, --name <name> | Project name | - | Yes |
-d, --description <description> | Project description | - | Yes |
--repo <repository> | Git repository URL | - | Yes |
projects show (alias: get)
Show project details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
--json | Output in JSON format | - | No |
projects update (alias: edit)
Update project name and description
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
-n, --name <name> | New project name | - | Yes |
-d, --description <description> | New project description | - | Yes |
--json | Output in JSON format | - | No |
-y, --yes | Skip prompts, use provided values (for automation) | - | No |
projects settings
Update project settings (slug, attack mode, preview environments)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
--slug <slug> | Project URL slug | - | Yes |
--attack-mode | Enable attack mode (CAPTCHA protection) | - | No |
--no-attack-mode | Disable attack mode | - | No |
--preview-envs | Enable preview environments | - | No |
--no-preview-envs | Disable preview environments | - | No |
--json | Output in JSON format | - | No |
-y, --yes | Skip prompts (for automation) | - | No |
projects git
Update git repository settings
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
--owner <owner> | Repository owner | - | Yes |
--repo <repo> | Repository name | - | Yes |
--branch <branch> | Main branch | - | Yes |
--directory <directory> | App directory path | - | Yes |
--preset <preset> | Build preset (auto, nextjs, nodejs, static, docker, rust, go, python) | - | Yes |
--json | Output in JSON format | - | No |
-y, --yes | Skip prompts, use provided/existing values (for automation) | - | No |
projects config
Update deployment configuration (resources, replicas)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
--replicas <n> | Number of container replicas | - | Yes |
--cpu-limit <limit> | CPU limit in cores (e.g., 0.5, 1, 2) | - | Yes |
--memory-limit <limit> | Memory limit in MB | - | Yes |
--auto-deploy | Enable automatic deployments | - | No |
--no-auto-deploy | Disable automatic deployments | - | No |
--json | Output in JSON format | - | No |
-y, --yes | Skip prompts (for automation) | - | No |
projects delete (alias: rm)
Delete a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation (alias for --force) | - | No |
deploy
Deploy a project from git
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
-e, --environment <env> | Target environment name | - | Yes |
--environment-id <id> | Target environment ID | - | Yes |
-b, --branch <branch> | Git branch to deploy | - | Yes |
-c, --commit <sha> | Specific commit SHA to deploy | - | Yes |
--no-wait | Do not wait for deployment to complete | - | No |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
deploy:static (alias: deploy-static)
Deploy static files (tar.gz, zip, or directory)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--path <path> | Path to static files archive or directory | - | Yes |
-p, --project <project> | Project slug or ID | - | Yes |
-e, --environment <env> | Target environment name | production | Yes |
--environment-id <id> | Target environment ID | - | Yes |
--no-wait | Do not wait for deployment to complete | - | No |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
--metadata <json> | Additional metadata (JSON format) | - | Yes |
--timeout <seconds> | Timeout in seconds for --wait | 300 | Yes |
deploy:image (alias: deploy-image)
Deploy a pre-built Docker image
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--image <image> | Docker image reference (e.g., ghcr.io/org/app:v1.0) | - | Yes |
-p, --project <project> | Project slug or ID | - | Yes |
-e, --environment <env> | Target environment name | production | Yes |
--environment-id <id> | Target environment ID | - | Yes |
--no-wait | Do not wait for deployment to complete | - | No |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
--metadata <json> | Additional metadata (JSON format) | - | Yes |
--timeout <seconds> | Timeout in seconds for --wait | 300 | Yes |
deploy:local-image (alias: deploy-local-image)
Build and deploy a local Docker image (or deploy existing image with --image)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--image <image> | Use existing local image instead of building (skips build) | - | Yes |
-f, --dockerfile <path> | Path to Dockerfile | Dockerfile | Yes |
-c, --context <path> | Build context directory | . | Yes |
--build-arg <arg...> | Build arguments (can be specified multiple times) | - | Yes |
--no-build | Skip building, requires --image | - | No |
-p, --project <project> | Project slug or ID | - | Yes |
-e, --environment <env> | Target environment name | production | Yes |
--environment-id <id> | Target environment ID | - | Yes |
-t, --tag <tag> | Tag for the built/uploaded image | - | Yes |
--no-wait | Do not wait for deployment to complete | - | No |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
--metadata <json> | Additional metadata (JSON format) | - | Yes |
--timeout <seconds> | Timeout in seconds for --wait | 600 | Yes |
deployments (alias: deploys)
Manage deployments
Subcommands:
list(ls) - List deploymentsstatus- Show deployment statusrollback- Rollback to previous deploymentcancel- Cancel a running deploymentpause- Pause a deploymentresume- Resume a paused deploymentteardown- Teardown a deployment and remove all resourceslogs- Show deployment build logs
deployments list (alias: ls)
List deployments
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
-e, --environment <env> | Filter by environment name (client-side) | - | Yes |
--environment-id <id> | Filter by environment ID (server-side) | - | Yes |
-n, --limit <number> | Limit results | 10 | Yes |
--page <n> | Page number | - | Yes |
--per-page <n> | Items per page | - | Yes |
--json | Output in JSON format | - | No |
deployments status
Show deployment status
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID (required) | - | Yes |
-d, --deployment-id <id> | Deployment ID (required) | - | Yes |
--json | Output in JSON format | - | No |
deployments rollback
Rollback to previous deployment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID (required) | - | Yes |
-e, --environment <env> | Target environment | production | Yes |
--to <deployment> | Rollback to specific deployment ID | - | Yes |
deployments cancel
Cancel a running deployment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project-id <id> | Project ID | - | Yes |
-d, --deployment-id <id> | Deployment ID | - | Yes |
-f, --force | Skip confirmation | - | No |
deployments pause
Pause a deployment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project-id <id> | Project ID | - | Yes |
-d, --deployment-id <id> | Deployment ID | - | Yes |
deployments resume
Resume a paused deployment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project-id <id> | Project ID | - | Yes |
-d, --deployment-id <id> | Deployment ID | - | Yes |
deployments teardown
Teardown a deployment and remove all resources
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project-id <id> | Project ID | - | Yes |
-d, --deployment-id <id> | Deployment ID | - | Yes |
-f, --force | Skip confirmation | - | No |
deployments logs
Show deployment build logs
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
-e, --environment <env> | Environment | production | Yes |
-f, --follow | Follow log output | - | No |
-n, --lines <number> | Number of lines to show | 100 | Yes |
-d, --deployment <id> | Specific deployment ID | - | Yes |
domains (alias: domain)
Manage custom domains
Subcommands:
list(ls) - List domainsadd- Add a custom domainverify- Verify domain and provision SSL certificateremove(rm) - Remove a domainssl- Manage SSL certificatestatus- Check domain statusorders(order) - Manage ACME orders for SSL certificate provisioningdns-challenge- Setup DNS challenge records automatically using a DNS providerhttp-debug- Debug HTTP-01 challenge for a domain
domains list (alias: ls)
List domains
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
domains add
Add a custom domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain name | - | Yes |
-c, --challenge <type> | Challenge type (http-01 or dns-01) | http-01 | Yes |
-y, --yes | Skip confirmation prompts | - | No |
domains verify
Verify domain and provision SSL certificate
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain name | - | Yes |
domains remove (alias: rm)
Remove a domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain name | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
domains ssl
Manage SSL certificate
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain name | - | Yes |
--renew | Force certificate renewal | - | No |
domains status
Check domain status
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain name | - | Yes |
domains orders (alias: order)
Manage ACME orders for SSL certificate provisioning
Subcommands:
list(ls) - List all ACME ordersshow- Show ACME order for a domaincreate- Create or recreate an ACME order for a domainfinalize- Finalize an ACME order (complete challenge validation)cancel- Cancel an ACME order for a domain
domains orders list (alias: ls)
List all ACME orders
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
domains orders show
Show ACME order for a domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--domain-id <id> | Domain ID | - | Yes |
--json | Output in JSON format | - | No |
domains orders create
Create or recreate an ACME order for a domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--domain-id <id> | Domain ID | - | Yes |
domains orders finalize
Finalize an ACME order (complete challenge validation)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--domain-id <id> | Domain ID | - | Yes |
domains orders cancel
Cancel an ACME order for a domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--domain-id <id> | Domain ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
domains dns-challenge
Setup DNS challenge records automatically using a DNS provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--domain-id <id> | Domain ID | - | Yes |
--provider-id <id> | DNS provider ID | - | Yes |
domains http-debug
Debug HTTP-01 challenge for a domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain name | - | Yes |
--json | Output in JSON format | - | No |
environments (alias: envs, env)
Manage environments and environment variables
Subcommands:
list(ls) - List environments for a projectcreate- Create a new environmentdelete(rm) - Delete an environmentvars- Manage environment variablesresources- View or set CPU/memory resources for an environmentscale- View or set the number of replicas for an environmentcrons- Manage cron jobs
environments list (alias: ls)
List environments for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
--json | Output in JSON format | - | No |
environments create
Create a new environment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
-n, --name <name> | Environment name | - | Yes |
-b, --branch <branch> | Git branch | - | Yes |
--preview | Set as preview environment | - | No |
environments delete (alias: rm)
Delete an environment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
-f, --force | Skip confirmation | - | No |
environments vars
Manage environment variables
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
Subcommands:
list(ls) - List environment variablesget- Get a specific environment variableset- Set an environment variabledelete(rm,unset) - Delete an environment variableimport- Import environment variables from a .env fileexport- Export environment variables to .env format
environments vars list (alias: ls)
List environment variables
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-e, --environment <name> | Filter by environment name | - | Yes |
--show-values | Show actual values (hidden by default) | - | No |
--json | Output in JSON format | - | No |
environments vars get
Get a specific environment variable
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-e, --environment <name> | Specify environment (if variable exists in multiple) | - | Yes |
environments vars set
Set an environment variable
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-e, --environments <names> | Comma-separated environment names (interactive if not provided) | - | Yes |
--no-preview | Exclude from preview environments | - | No |
--update | Update existing variable instead of creating new | - | No |
environments vars delete (alias: rm, unset)
Delete an environment variable
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-e, --environment <name> | Delete only from specific environment | - | Yes |
-f, --force | Skip confirmation | - | No |
environments vars import
Import environment variables from a .env file
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-e, --environments <names> | Comma-separated environment names | - | Yes |
--overwrite | Overwrite existing variables | - | No |
environments vars export
Export environment variables to .env format
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-e, --environment <name> | Export from specific environment | - | Yes |
-o, --output <file> | Write to file instead of stdout | - | Yes |
environments resources
View or set CPU/memory resources for an environment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
--cpu <millicores> | CPU limit in millicores (e.g., 500 = 0.5 CPU) | - | Yes |
--memory <mb> | Memory limit in MB (e.g., 512) | - | Yes |
--cpu-request <millicores> | CPU request in millicores (guaranteed minimum) | - | Yes |
--memory-request <mb> | Memory request in MB (guaranteed minimum) | - | Yes |
--json | Output in JSON format | - | No |
environments scale
View or set the number of replicas for an environment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
-e, --environment <env> | Environment name or slug | production | Yes |
-r, --replicas <count> | Number of replicas to set | - | Yes |
--json | Output in JSON format | - | No |
environments crons
Manage cron jobs
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
-e, --environment <env> | Environment name or slug | - | Yes |
Subcommands:
list(ls) - List cron jobs for an environmentshow- Show cron job detailsexecutions(execs) - Show cron job execution history
environments crons list (alias: ls)
List cron jobs for an environment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
environments crons show
Show cron job details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Cron job ID | - | Yes |
--json | Output in JSON format | - | No |
environments crons executions (alias: execs)
Show cron job execution history
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Cron job ID | - | Yes |
--page <page> | Page number | 1 | Yes |
--per-page <count> | Items per page | 20 | Yes |
--json | Output in JSON format | - | No |
providers (alias: provider)
Manage Git providers
Subcommands:
list(ls) - List configured Git providersadd- Add a new Git providerremove(rm) - Remove a Git providershow- Show Git provider detailsactivate- Activate a Git providerdeactivate- Deactivate a Git providersafe-delete- Safely delete a Git provider (checks dependencies first)deletion-check- Check if a Git provider can be safely deletedgit- Manage Git providersconnections(conn) - Manage Git provider connections
providers list (alias: ls)
List configured Git providers
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
providers add
Add a new Git provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --provider <provider> | Provider type (github, gitlab) | - | Yes |
-n, --name <name> | Provider name | - | Yes |
-t, --token <token> | Personal access token | - | Yes |
--base-url <url> | GitLab base URL (for self-hosted GitLab) | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
providers remove (alias: rm)
Remove a Git provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
providers show
Show Git provider details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--json | Output in JSON format | - | No |
providers activate
Activate a Git provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
providers deactivate
Deactivate a Git provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
providers safe-delete
Safely delete a Git provider (checks dependencies first)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
providers deletion-check
Check if a Git provider can be safely deleted
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--json | Output in JSON format | - | No |
providers git
Manage Git providers
Subcommands:
connect- Connect a Git provider (github, gitlab)repos- List available repositories
providers git connect
Connect a Git provider (github, gitlab)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --provider <provider> | Provider type (github, gitlab) | - | Yes |
-n, --name <name> | Provider name | - | Yes |
-t, --token <token> | Personal access token | - | Yes |
--base-url <url> | GitLab base URL (for self-hosted GitLab) | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
providers git repos
List available repositories
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID (optional, lists all if not provided) | - | Yes |
--json | Output in JSON format | - | No |
--search <term> | Search repositories by name | - | Yes |
--page <n> | Page number | - | Yes |
--per-page <n> | Items per page (max: 100) | - | Yes |
--sort <field> | Sort by field (name, created_at, updated_at, stars) | - | Yes |
--direction <dir> | Sort direction: asc or desc | - | Yes |
--language <lang> | Filter by programming language | - | Yes |
--owner <owner> | Filter by repository owner | - | Yes |
providers connections (alias: conn)
Manage Git provider connections
Subcommands:
list(ls) - List all Git connectionsshow- Show connection details for a providerdelete(rm) - Delete a Git connectionactivate- Activate a Git connectiondeactivate- Deactivate a Git connectionsync- Sync repositories for a Git connectionupdate-token- Update access token for a Git connectionvalidate- Validate a Git connection
providers connections list (alias: ls)
List all Git connections
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
--page <n> | Page number | - | Yes |
--per-page <n> | Items per page (default: 30, max: 100) | - | Yes |
--sort <field> | Sort by field (created_at, updated_at, account_name) | - | Yes |
--direction <dir> | Sort direction: asc or desc (default: desc) | - | Yes |
providers connections show
Show connection details for a provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--json | Output in JSON format | - | No |
providers connections delete (alias: rm)
Delete a Git connection
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Connection ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
providers connections activate
Activate a Git connection
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Connection ID | - | Yes |
providers connections deactivate
Deactivate a Git connection
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Connection ID | - | Yes |
providers connections sync
Sync repositories for a Git connection
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Connection ID | - | Yes |
providers connections update-token
Update access token for a Git connection
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Connection ID | - | Yes |
-t, --token <token> | New access token | - | Yes |
providers connections validate
Validate a Git connection
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Connection ID | - | Yes |
--json | Output in JSON format | - | No |
backups (alias: backup)
Manage backup schedules and backups
Subcommands:
schedules(schedule) - Manage backup schedulessources(source) - Manage S3 backup sourceslist(ls) - List backups for a scheduleshow- Show backup detailsrun-service- Run a backup for an external service
backups schedules (alias: schedule)
Manage backup schedules
Subcommands:
list(ls) - List backup schedulescreate- Create a backup scheduleshow- Show backup schedule detailsenable- Enable a backup scheduledisable- Disable a backup scheduledelete(rm) - Delete a backup schedule
backups schedules list (alias: ls)
List backup schedules
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
backups schedules create
Create a backup schedule
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-n, --name <name> | Schedule name | - | Yes |
-t, --type <type> | Backup type (full, incremental) | - | Yes |
-s, --schedule <cron> | Schedule expression (cron format) | - | Yes |
-r, --retention <days> | Retention period in days | - | Yes |
-d, --description <desc> | Description | - | Yes |
--s3-source-id <id> | S3 Source ID | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
backups schedules show
Show backup schedule details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Schedule ID | - | Yes |
--json | Output in JSON format | - | No |
backups schedules enable
Enable a backup schedule
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Schedule ID | - | Yes |
backups schedules disable
Disable a backup schedule
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Schedule ID | - | Yes |
backups schedules delete (alias: rm)
Delete a backup schedule
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Schedule ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
backups sources (alias: source)
Manage S3 backup sources
Subcommands:
list(ls) - List S3 sourcescreate- Create an S3 sourceshow- Show S3 source detailsupdate- Update an S3 sourceremove(rm) - Delete an S3 sourcebackups- List backups for an S3 sourcerun- Trigger a backup for an S3 source
backups sources list (alias: ls)
List S3 sources
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
backups sources create
Create an S3 source
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-n, --name <name> | Source name | - | Yes |
--bucket <bucket> | S3 bucket name | - | Yes |
--region <region> | S3 region | - | Yes |
--endpoint <endpoint> | S3 endpoint (for S3-compatible services) | - | Yes |
--access-key <key> | Access key ID | - | Yes |
--secret-key <key> | Secret access key | - | Yes |
--prefix <prefix> | Bucket path/prefix | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
backups sources show
Show S3 source details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | S3 source ID | - | Yes |
--json | Output in JSON format | - | No |
backups sources update
Update an S3 source
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | S3 source ID | - | Yes |
-n, --name <name> | New source name | - | Yes |
--bucket <bucket> | New S3 bucket name | - | Yes |
--region <region> | New S3 region | - | Yes |
--endpoint <endpoint> | New S3 endpoint | - | Yes |
--access-key <key> | New access key ID | - | Yes |
--secret-key <key> | New secret access key | - | Yes |
--prefix <prefix> | New bucket path/prefix | - | Yes |
backups sources remove (alias: rm)
Delete an S3 source
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | S3 source ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
backups sources backups
List backups for an S3 source
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | S3 source ID | - | Yes |
--json | Output in JSON format | - | No |
backups sources run
Trigger a backup for an S3 source
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | S3 source ID | - | Yes |
backups list (alias: ls)
List backups for a schedule
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--schedule-id <id> | Schedule ID | - | Yes |
--json | Output in JSON format | - | No |
backups show
Show backup details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Backup ID | - | Yes |
--json | Output in JSON format | - | No |
backups run-service
Run a backup for an external service
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | External service ID | - | Yes |
--s3-source-id <id> | S3 source ID to store the backup | - | Yes |
-t, --type <type> | Backup type (e.g., full, incremental) | - | Yes |
runtime-logs (alias: rlogs)
View runtime container logs (use -f to follow in real-time)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
-e, --environment <env> | Environment name | production | Yes |
-c, --container <id> | Container ID (partial match supported) | - | Yes |
-n, --tail <lines> | Number of lines to tail | 1000 | Yes |
-t, --timestamps | Show timestamps | - | No |
-f, --follow | Follow log output (stream in real-time) | - | No |
notifications (alias: notify)
Manage notification providers (Slack, Email, Webhook, etc.)
Subcommands:
list(ls) - List configured notification providersadd- Add a new notification providerupdate- Update a notification providerenable- Enable a notification providerdisable- Disable a notification providershow- Show notification provider detailsremove(rm) - Remove a notification providertest- Send a test notification
notifications list (alias: ls)
List configured notification providers
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
notifications add
Add a new notification provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-t, --type <type> | Provider type (slack, email, webhook) | - | Yes |
-n, --name <name> | Provider name | - | Yes |
-w, --webhook-url <url> | Webhook URL (for slack) | - | Yes |
-c, --channel <channel> | Channel name (for slack, optional) | - | Yes |
--smtp-host <host> | SMTP host (for email) | - | Yes |
--smtp-port <port> | SMTP port (for email) | - | Yes |
--username <username> | SMTP username (for email) | - | Yes |
--password <password> | SMTP password (for email) | - | Yes |
--from-address <address> | From email address (for email) | - | Yes |
--from-name <name> | From display name (for email, optional) | - | Yes |
--to-addresses <addresses> | Comma-separated recipient addresses (for email) | - | Yes |
--url <url> | Webhook URL (for webhook) | - | Yes |
--method <method> | HTTP method: POST, PUT, PATCH (for webhook, default: POST) | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
notifications update
Update a notification provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
-n, --name <name> | New provider name | - | Yes |
--enabled <enabled> | Enable or disable (true/false) | - | Yes |
-w, --webhook-url <url> | Webhook URL (for slack) | - | Yes |
-c, --channel <channel> | Channel name (for slack) | - | Yes |
--smtp-host <host> | SMTP host (for email) | - | Yes |
--smtp-port <port> | SMTP port (for email) | - | Yes |
--username <username> | SMTP username (for email) | - | Yes |
--password <password> | SMTP password (for email) | - | Yes |
--from-address <address> | From email address (for email) | - | Yes |
--from-name <name> | From display name (for email) | - | Yes |
--to-addresses <addresses> | Comma-separated recipient addresses (for email) | - | Yes |
--url <url> | Webhook URL (for webhook) | - | Yes |
--method <method> | HTTP method: POST, PUT, PATCH (for webhook) | - | Yes |
--json | Output in JSON format | - | No |
-y, --yes | Skip confirmation prompts | - | No |
notifications enable
Enable a notification provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--json | Output in JSON format | - | No |
notifications disable
Disable a notification provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--json | Output in JSON format | - | No |
notifications show
Show notification provider details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--json | Output in JSON format | - | No |
notifications remove (alias: rm)
Remove a notification provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
notifications test
Send a test notification
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
dns
Manage DNS providers for automated domain verification
Subcommands:
list(ls) - List configured DNS providersadd- Add a new DNS providershow- Show DNS provider detailsremove(rm) - Remove a DNS providertest- Test DNS provider connectionzones- List available zones in a DNS provider
dns list (alias: ls)
List configured DNS providers
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
dns add
Add a new DNS provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-t, --type <type> | Provider type (cloudflare, route53, digitalocean, namecheap, gcp, azure, manual) | - | Yes |
-n, --name <name> | Provider name | - | Yes |
-d, --description <description> | Provider description | - | Yes |
--api-token <token> | Cloudflare API token | - | Yes |
--account-id <id> | Cloudflare account ID (optional) | - | Yes |
--access-key-id <key> | AWS access key ID | - | Yes |
--secret-access-key <secret> | AWS secret access key | - | Yes |
--region <region> | AWS region | - | Yes |
--api-user <user> | Namecheap API user | - | Yes |
--api-key <key> | Namecheap API key | - | Yes |
--username <username> | Namecheap username | - | Yes |
--client-ip <ip> | Namecheap whitelisted client IP | - | Yes |
--project-id <id> | GCP project ID | - | Yes |
--service-account-email <email> | GCP service account email | - | Yes |
--private-key-id <id> | GCP private key ID | - | Yes |
--private-key <key> | GCP private key | - | Yes |
--tenant-id <id> | Azure tenant ID | - | Yes |
--client-id <id> | Azure client ID | - | Yes |
--client-secret <secret> | Azure client secret | - | Yes |
--subscription-id <id> | Azure subscription ID | - | Yes |
--resource-group <name> | Azure resource group | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
dns show
Show DNS provider details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--json | Output in JSON format | - | No |
dns remove (alias: rm)
Remove a DNS provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation (alias for --force) | - | No |
dns test
Test DNS provider connection
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
dns zones
List available zones in a DNS provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--json | Output in JSON format | - | No |
services (alias: svc)
Manage external services (databases, caches, storage)
Subcommands:
list(ls) - List all external servicescreate(add) - Create a new external serviceshow- Show service detailsremove(rm) - Remove a servicestart- Start a stopped servicestop- Stop a running servicetypes- List available service typesprojects- List projects linked to a serviceupdate- Update a serviceupgrade- Upgrade a service to a newer versionimport- Import an existing external servicelink- Link a service to a projectunlink- Unlink a service from a projectenv- Show environment variables for a linked serviceenv-var- Get a specific environment variable
services list (alias: ls)
List all external services
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
services create (alias: add)
Create a new external service
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-t, --type <type> | Service type (postgres, mongodb, redis, s3) | - | Yes |
-n, --name <name> | Service name | - | Yes |
-s, --set <key=value> | Set a parameter (repeatable) | `` | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
services show
Show service details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Service ID | - | Yes |
--json | Output in JSON format | - | No |
services remove (alias: rm)
Remove a service
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Service ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
services start
Start a stopped service
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Service ID | - | Yes |
services stop
Stop a running service
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Service ID | - | Yes |
services types
List available service types
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
Subcommands:
info- Show parameters schema for a service type (useful for automation)
services types info
Show parameters schema for a service type (useful for automation)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output as raw JSON schema (default) | - | No |
services projects
List projects linked to a service
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Service ID | - | Yes |
--json | Output in JSON format | - | No |
services update
Update a service
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Service ID | - | Yes |
-n, --name <name> | Docker image name (e.g., postgres:18-alpine) | - | Yes |
-s, --set <key=value> | Set a parameter (repeatable) | `` | Yes |
services upgrade
Upgrade a service to a newer version
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Service ID | - | Yes |
-v, --version <version> | Docker image to upgrade to (e.g., postgres:18-alpine) | - | Yes |
services import
Import an existing external service
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-t, --type <type> | Service type (postgres, mongodb, redis, s3) | - | Yes |
-n, --name <name> | Service name | - | Yes |
--container-id <id> | Container ID or name to import | - | Yes |
-s, --set <key=value> | Set a parameter (repeatable) | `` | Yes |
--version <version> | Optional version override | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
services link
Link a service to a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Service ID | - | Yes |
-p, --project <slug> | Project slug (auto-detected from .temps/config.json) | - | Yes |
services unlink
Unlink a service from a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Service ID | - | Yes |
-p, --project <slug> | Project slug (auto-detected from .temps/config.json) | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
services env
Show environment variables for a linked service
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Service ID | - | Yes |
-p, --project <slug> | Project slug (auto-detected from .temps/config.json) | - | Yes |
--json | Output in JSON format | - | No |
services env-var
Get a specific environment variable
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Service ID | - | Yes |
-p, --project <slug> | Project slug (auto-detected from .temps/config.json) | - | Yes |
--var <name> | Environment variable name | - | Yes |
--json | Output in JSON format | - | No |
settings
Manage platform settings
Subcommands:
show(get) - Show current platform settingsupdate(set) - Update platform settingsset-external-url- Set the external URL for the platformset-preview-domain- Set the preview domain pattern
settings show (alias: get)
Show current platform settings
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
settings update (alias: set)
Update platform settings
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-s, --setting <setting> | Setting to update (external_url, preview_domain, letsencrypt, rate_limiting, security_headers, screenshots) | - | Yes |
-v, --value <value> | Value for the setting | - | Yes |
--external-url <url> | External URL for the platform | - | Yes |
--preview-domain <domain> | Preview domain pattern | - | Yes |
--letsencrypt-email <email> | Let's Encrypt email | - | Yes |
--letsencrypt-mode <mode> | Let's Encrypt mode (staging, production) | - | Yes |
--rate-limiting-enabled <enabled> | Enable rate limiting (true/false) | - | Yes |
--rate-limiting-rpm <rpm> | Requests per minute | - | Yes |
--screenshots-enabled <enabled> | Enable screenshots (true/false) | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
settings set-external-url
Set the external URL for the platform
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--url <url> | External URL | - | Yes |
settings set-preview-domain
Set the preview domain pattern
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--domain <domain> | Preview domain pattern | - | Yes |
users
Manage platform users
Subcommands:
list(ls) - List all userscreate(add) - Create a new userme- Show current user inforemove(rm) - Remove a userrestore- Restore a deleted userrole- Manage user roles
users list (alias: ls)
List all users
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
users create (alias: add)
Create a new user
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-u, --username <username> | Username | - | Yes |
-e, --email <email> | Email address | - | Yes |
-p, --password <password> | Password (if not provided, invite email will be sent) | - | Yes |
-r, --roles <roles> | Comma-separated roles (admin, developer, viewer) | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
users me
Show current user info
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
users remove (alias: rm)
Remove a user
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | User ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
users restore
Restore a deleted user
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | User ID | - | Yes |
users role
Manage user roles
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | User ID | - | Yes |
--add <role> | Add a role to user | - | Yes |
--remove <role> | Remove a role from user | - | Yes |
apikeys (alias: keys)
Manage API keys for programmatic access
Subcommands:
list(ls) - List all API keyscreate(add) - Create a new API keyshow- Show API key detailsremove(rm) - Delete an API keyactivate- Activate a deactivated API keydeactivate- Deactivate an API keypermissions- List available API key permissions
apikeys list (alias: ls)
List all API keys
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
apikeys create (alias: add)
Create a new API key
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-n, --name <name> | API key name | - | Yes |
-r, --role <role> | Role type (admin, developer, viewer, readonly) | - | Yes |
-e, --expires-in <days> | Expires in N days (7, 30, 90, 365) | - | Yes |
-p, --permissions <permissions> | Comma-separated list of permissions | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
apikeys show
Show API key details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | API key ID | - | Yes |
--json | Output in JSON format | - | No |
apikeys remove (alias: rm)
Delete an API key
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | API key ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
apikeys activate
Activate a deactivated API key
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | API key ID | - | Yes |
apikeys deactivate
Deactivate an API key
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | API key ID | - | Yes |
apikeys permissions
List available API key permissions
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
monitors
Manage uptime monitors for status pages
Subcommands:
list(ls) - List all monitors for a projectcreate(add) - Create a new monitor for a projectshow- Show monitor details and current statusremove(rm) - Delete a monitorstatus- Get current monitor statushistory- Get monitor uptime history
monitors list (alias: ls)
List all monitors for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--json | Output in JSON format | - | No |
monitors create (alias: add)
Create a new monitor for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
-n, --name <name> | Monitor name | - | Yes |
-t, --type <type> | Monitor type (http, tcp, ping) | - | Yes |
-i, --interval <seconds> | Check interval in seconds (60, 300, 600, 900, 1800) | - | Yes |
--environment-id <id> | Environment ID (default: 0 for production) | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
monitors show
Show monitor details and current status
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Monitor ID | - | Yes |
--json | Output in JSON format | - | No |
monitors remove (alias: rm)
Delete a monitor
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Monitor ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
monitors status
Get current monitor status
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Monitor ID | - | Yes |
--json | Output in JSON format | - | No |
monitors history
Get monitor uptime history
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Monitor ID | - | Yes |
--json | Output in JSON format | - | No |
--days <days> | Number of days to show | 7 | Yes |
webhooks (alias: hooks)
Manage webhooks for project events
Subcommands:
list(ls) - List all webhooks for a projectcreate(add) - Create a new webhook for a projectshow- Show webhook detailsupdate- Update a webhookremove(rm) - Delete a webhookenable- Enable a webhookdisable- Disable a webhookevents- List available webhook event typesdeliveries- Manage webhook deliveries
webhooks list (alias: ls)
List all webhooks for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--json | Output in JSON format | - | No |
webhooks create (alias: add)
Create a new webhook for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
-u, --url <url> | Webhook URL | - | Yes |
-e, --events <events> | Comma-separated event types (or "all" for all events) | - | Yes |
-s, --secret <secret> | Webhook secret for signature verification | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
webhooks show
Show webhook details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--webhook-id <id> | Webhook ID | - | Yes |
--json | Output in JSON format | - | No |
webhooks update
Update a webhook
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--webhook-id <id> | Webhook ID | - | Yes |
-u, --url <url> | New webhook URL | - | Yes |
-e, --events <events> | Comma-separated event types (or "all" for all events) | - | Yes |
-s, --secret <secret> | New webhook secret for signature verification | - | Yes |
webhooks remove (alias: rm)
Delete a webhook
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--webhook-id <id> | Webhook ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
webhooks enable
Enable a webhook
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--webhook-id <id> | Webhook ID | - | Yes |
webhooks disable
Disable a webhook
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--webhook-id <id> | Webhook ID | - | Yes |
webhooks events
List available webhook event types
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
webhooks deliveries
Manage webhook deliveries
Subcommands:
list(ls) - List deliveries for a webhookshow- Show delivery detailsretry- Retry a failed delivery
webhooks deliveries list (alias: ls)
List deliveries for a webhook
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--webhook-id <id> | Webhook ID | - | Yes |
--limit <n> | Number of deliveries to return (default: 50) | - | Yes |
--json | Output in JSON format | - | No |
webhooks deliveries show
Show delivery details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--webhook-id <id> | Webhook ID | - | Yes |
--delivery-id <id> | Delivery ID | - | Yes |
--json | Output in JSON format | - | No |
webhooks deliveries retry
Retry a failed delivery
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--webhook-id <id> | Webhook ID | - | Yes |
--delivery-id <id> | Delivery ID | - | Yes |
containers (alias: cts)
Manage project containers in environments
Subcommands:
list(ls) - List all containers in an environmentshow- Show container detailsstart- Start a stopped containerstop- Stop a running containerrestart- Restart a containermetrics- Get container resource metrics (all containers if no container ID specified)
containers list (alias: ls)
List all containers in an environment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project-id <id> | Project ID | - | Yes |
-e, --environment-id <id> | Environment ID | - | Yes |
--json | Output in JSON format | - | No |
containers show
Show container details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project-id <id> | Project ID | - | Yes |
-e, --environment-id <id> | Environment ID | - | Yes |
-c, --container-id <id> | Container ID | - | Yes |
--json | Output in JSON format | - | No |
containers start
Start a stopped container
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project-id <id> | Project ID | - | Yes |
-e, --environment-id <id> | Environment ID | - | Yes |
-c, --container-id <id> | Container ID | - | Yes |
containers stop
Stop a running container
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project-id <id> | Project ID | - | Yes |
-e, --environment-id <id> | Environment ID | - | Yes |
-c, --container-id <id> | Container ID | - | Yes |
-f, --force | Skip confirmation | - | No |
containers restart
Restart a container
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project-id <id> | Project ID | - | Yes |
-e, --environment-id <id> | Environment ID | - | Yes |
-c, --container-id <id> | Container ID | - | Yes |
containers metrics
Get container resource metrics (all containers if no container ID specified)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project-id <id> | Project ID | - | Yes |
-e, --environment-id <id> | Environment ID | - | Yes |
-c, --container-id <id> | Container ID (optional - shows all if not specified) | - | Yes |
--json | Output in JSON format | - | No |
-w, --watch | Watch mode - continuously update metrics | - | No |
-i, --interval <seconds> | Refresh interval in seconds (default: 2) | 2 | Yes |
tokens (alias: token)
Manage deployment tokens for project API access (KV, Blob, etc.)
Subcommands:
list(ls) - List deployment tokens for a projectcreate(add) - Create a new deployment tokenshow(get) - Show deployment token detailsdelete(rm) - Delete a deployment tokenpermissions- List available deployment token permissions
tokens list (alias: ls)
List deployment tokens for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
--json | Output in JSON format | - | No |
tokens create (alias: add)
Create a new deployment token
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
-n, --name <name> | Token name | - | Yes |
--permissions <permissions> | Comma-separated permissions (e.g., "visitors:enrich,emails:send" or "*" for full access) | - | Yes |
-e, --expires-in <days> | Expires in N days (7, 30, 90, 365, or "never") | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
tokens show (alias: get)
Show deployment token details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
--id <id> | Token ID | - | Yes |
--json | Output in JSON format | - | No |
tokens delete (alias: rm)
Delete a deployment token
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
--id <id> | Token ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation (alias for --force) | - | No |
tokens permissions
List available deployment token permissions
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
errors (alias: error)
Manage error tracking and error groups
Subcommands:
list(ls) - List error groups for a projectshow- Show error group detailsupdate- Update error group statusevents- List events in an error groupevent- Show a specific error eventstats- Get error statistics for a projecttimeline- Get error time series datadashboard- Get error dashboard statistics
errors list (alias: ls)
List error groups for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--status <status> | Filter by status (unresolved, resolved, ignored) | - | Yes |
--page <page> | Page number | - | Yes |
--page-size <size> | Page size | - | Yes |
--environment-id <id> | Filter by environment ID | - | Yes |
--start-date <date> | Filter by start date (ISO 8601) | - | Yes |
--end-date <date> | Filter by end date (ISO 8601) | - | Yes |
--sort-by <field> | Sort by field (e.g., total_count, last_seen, first_seen) | - | Yes |
--sort-order <order> | Sort order: asc or desc | - | Yes |
--json | Output in JSON format | - | No |
errors show
Show error group details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--group-id <id> | Error group ID | - | Yes |
--json | Output in JSON format | - | No |
errors update
Update error group status
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--group-id <id> | Error group ID | - | Yes |
--status <status> | New status (unresolved, resolved, ignored) | - | Yes |
--assigned-to <user> | Assign to user | - | Yes |
errors events
List events in an error group
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--group-id <id> | Error group ID | - | Yes |
--page <page> | Page number | - | Yes |
--page-size <size> | Page size | - | Yes |
--json | Output in JSON format | - | No |
errors event
Show a specific error event
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--group-id <id> | Error group ID | - | Yes |
--event-id <id> | Error event ID | - | Yes |
--json | Output in JSON format | - | No |
errors stats
Get error statistics for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--json | Output in JSON format | - | No |
errors timeline
Get error time series data
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--days <days> | Number of days to show | 7 | Yes |
--bucket <bucket> | Time bucket size (e.g., "1h", "15m", "1d") | 1h | Yes |
--json | Output in JSON format | - | No |
errors dashboard
Get error dashboard statistics
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--days <days> | Number of days to show | 7 | Yes |
--compare | Compare to previous period | - | No |
--json | Output in JSON format | - | No |
kv
KV store commands (coming soon)
Subcommands:
get- Get a value by keyset- Set a key-value pairdel(delete) - Delete a keykeys(ls) - List keysttl- Get the TTL (time-to-live) for a keyexpire- Set expiry on an existing keyincr- Increment a numeric valueenable- Enable KV store for a projectdisable- Disable KV store for a projectstatus- Get KV store status for a project
kv get
Get a value by key
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--key <key> | Key to retrieve | - | Yes |
kv set
Set a key-value pair
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--key <key> | Key to set | - | Yes |
--value <value> | Value to set | - | Yes |
--ttl <seconds> | Time-to-live in seconds | - | Yes |
kv del (alias: delete)
Delete a key
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--key <key> | Key to delete | - | Yes |
kv keys (alias: ls)
List keys
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--pattern <pattern> | Key pattern to filter by (e.g., "user:*") | - | Yes |
--json | Output in JSON format | - | No |
kv ttl
Get the TTL (time-to-live) for a key
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--key <key> | Key to check | - | Yes |
kv expire
Set expiry on an existing key
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--key <key> | Key to set expiry on | - | Yes |
--ttl <seconds> | Time-to-live in seconds | - | Yes |
kv incr
Increment a numeric value
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--key <key> | Key to increment | - | Yes |
kv enable
Enable KV store for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
kv disable
Disable KV store for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
kv status
Get KV store status for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--json | Output in JSON format | - | No |
blob
Blob storage commands (coming soon)
Subcommands:
list(ls) - List blobs in a projectupload(put) - Upload a file as a blobdelete(rm) - Delete a blobcopy(cp) - Copy a blob to a new keydownload(get) - Download a blob to a local filehead- Get blob metadata (size, content type, etc.)enable- Enable blob storage for a projectdisable- Disable blob storage for a projectstatus- Get blob storage status for a project
blob list (alias: ls)
List blobs in a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--prefix <prefix> | Filter by key prefix | - | Yes |
--json | Output in JSON format | - | No |
blob upload (alias: put)
Upload a file as a blob
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--key <key> | Blob key (path) | - | Yes |
--file <path> | Local file path to upload | - | Yes |
blob delete (alias: rm)
Delete a blob
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--key <key> | Blob key to delete | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation (alias for --force) | - | No |
blob copy (alias: cp)
Copy a blob to a new key
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--source <key> | Source blob key | - | Yes |
--dest <key> | Destination blob key | - | Yes |
blob download (alias: get)
Download a blob to a local file
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--key <key> | Blob key to download | - | Yes |
--output <path> | Local file path to save to | - | Yes |
blob head
Get blob metadata (size, content type, etc.)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--key <key> | Blob key | - | Yes |
--json | Output in JSON format | - | No |
blob enable
Enable blob storage for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
blob disable
Disable blob storage for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
blob status
Get blob storage status for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--json | Output in JSON format | - | No |
dsn
Manage Data Source Names (DSNs) for error tracking and analytics
Subcommands:
list(ls) - List all DSNs for a projectcreate(add) - Create a new DSN for a projectget-or-create- Get an existing DSN or create one if none existsregenerate- Regenerate DSN keys (rotate keys)revoke- Revoke (deactivate) a DSN
dsn list (alias: ls)
List all DSNs for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--json | Output in JSON format | - | No |
dsn create (alias: add)
Create a new DSN for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
-n, --name <name> | DSN name | - | Yes |
--environment-id <id> | Environment ID | - | Yes |
--deployment-id <id> | Deployment ID | - | Yes |
--base-url <url> | Base URL for the DSN | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
dsn get-or-create
Get an existing DSN or create one if none exists
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--environment-id <id> | Environment ID | - | Yes |
--deployment-id <id> | Deployment ID | - | Yes |
--base-url <url> | Base URL for the DSN | - | Yes |
--json | Output in JSON format | - | No |
dsn regenerate
Regenerate DSN keys (rotate keys)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--dsn-id <id> | DSN ID | - | Yes |
--base-url <url> | New base URL for the DSN | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation (alias for --force) | - | No |
dsn revoke
Revoke (deactivate) a DSN
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--dsn-id <id> | DSN ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation (alias for --force) | - | No |
scans (alias: scan)
Manage vulnerability scans
Subcommands:
list(ls) - List vulnerability scans for a projecttrigger- Trigger a new vulnerability scanlatest- Get the latest scan for a projectenvironments(envs) - Get latest scans per environmentshow- Show scan detailsvulnerabilities(vulns) - List vulnerabilities found in a scanremove(rm) - Delete a vulnerability scanby-deployment- Get the scan for a specific deployment
scans list (alias: ls)
List vulnerability scans for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--page <n> | Page number | - | Yes |
--page-size <n> | Items per page (default: 20, max: 100) | - | Yes |
--json | Output in JSON format | - | No |
scans trigger
Trigger a new vulnerability scan
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--environment-id <id> | Environment ID to scan | - | Yes |
scans latest
Get the latest scan for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--environment-id <id> | Filter by environment ID | - | Yes |
--json | Output in JSON format | - | No |
scans environments (alias: envs)
Get latest scans per environment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--json | Output in JSON format | - | No |
scans show
Show scan details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Scan ID | - | Yes |
--json | Output in JSON format | - | No |
scans vulnerabilities (alias: vulns)
List vulnerabilities found in a scan
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Scan ID | - | Yes |
--severity <level> | Filter by severity (CRITICAL, HIGH, MEDIUM, LOW) | - | Yes |
--json | Output in JSON format | - | No |
scans remove (alias: rm)
Delete a vulnerability scan
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Scan ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
scans by-deployment
Get the scan for a specific deployment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--deployment-id <id> | Deployment ID | - | Yes |
--json | Output in JSON format | - | No |
custom-domains (alias: cdom)
Manage project custom domains
Subcommands:
list(ls) - List custom domains for a projectcreate(add) - Create a custom domain for a projectshow- Show custom domain detailsupdate- Update a custom domainremove(rm) - Remove a custom domainlink-cert- Link a custom domain to a certificate
custom-domains list (alias: ls)
List custom domains for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--json | Output in JSON format | - | No |
custom-domains create (alias: add)
Create a custom domain for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
-d, --domain <domain> | Domain name | - | Yes |
--environment-id <id> | Environment ID | 0 | Yes |
--branch <branch> | Branch name | - | Yes |
--redirect-to <url> | Redirect target URL | - | Yes |
--status-code <code> | HTTP status code for redirects | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
custom-domains show
Show custom domain details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--domain-id <id> | Custom domain ID | - | Yes |
--json | Output in JSON format | - | No |
custom-domains update
Update a custom domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--domain-id <id> | Custom domain ID | - | Yes |
-d, --domain <domain> | New domain name | - | Yes |
--environment-id <id> | New environment ID | - | Yes |
--branch <branch> | New branch name | - | Yes |
--redirect-to <url> | New redirect target URL | - | Yes |
--status-code <code> | New HTTP status code for redirects | - | Yes |
custom-domains remove (alias: rm)
Remove a custom domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--domain-id <id> | Custom domain ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation (alias for --force) | - | No |
custom-domains link-cert
Link a custom domain to a certificate
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--domain-id <id> | Custom domain ID | - | Yes |
--certificate-id <id> | Certificate ID | - | Yes |
dns-provider (alias: dnsp)
Manage DNS providers and managed domains
Subcommands:
list(ls) - List all DNS providerscreate(add) - Create a new DNS providershow- Show DNS provider detailsupdate- Update a DNS providerremove(rm) - Delete a DNS providertest- Test DNS provider connectionzones- List DNS zones for a providerdomains- Manage domains associated with a DNS providerlookup- Lookup DNS A records for a domain
dns-provider list (alias: ls)
List all DNS providers
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
dns-provider create (alias: add)
Create a new DNS provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-n, --name <name> | Provider name | - | Yes |
-t, --type <type> | Provider type (cloudflare, route53, digitalocean, namecheap, gcp, azure, manual) | - | Yes |
-d, --description <description> | Provider description | - | Yes |
--api-token <token> | API token (Cloudflare, DigitalOcean) | - | Yes |
--account-id <id> | Cloudflare account ID (optional) | - | Yes |
--access-key-id <key> | AWS access key ID | - | Yes |
--secret-access-key <secret> | AWS secret access key | - | Yes |
--region <region> | AWS region | - | Yes |
--api-user <user> | Namecheap API user | - | Yes |
--api-key <key> | Namecheap API key | - | Yes |
--username <username> | Namecheap username | - | Yes |
--client-ip <ip> | Namecheap whitelisted client IP | - | Yes |
--project-id <id> | GCP project ID | - | Yes |
--service-account-email <email> | GCP service account email | - | Yes |
--private-key-id <id> | GCP private key ID | - | Yes |
--private-key <key> | GCP private key | - | Yes |
--tenant-id <id> | Azure tenant ID | - | Yes |
--client-id <id> | Azure client ID | - | Yes |
--client-secret <secret> | Azure client secret | - | Yes |
--subscription-id <id> | Azure subscription ID | - | Yes |
--resource-group <name> | Azure resource group | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
dns-provider show
Show DNS provider details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--json | Output in JSON format | - | No |
dns-provider update
Update a DNS provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
-n, --name <name> | New provider name | - | Yes |
-d, --description <description> | New description | - | Yes |
--api-key <key> | New API key/token | - | Yes |
--active <boolean> | Set active status (true/false) | - | Yes |
dns-provider remove (alias: rm)
Delete a DNS provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
dns-provider test
Test DNS provider connection
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
dns-provider zones
List DNS zones for a provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--json | Output in JSON format | - | No |
dns-provider domains
Manage domains associated with a DNS provider
Subcommands:
list(ls) - List managed domains for a provideradd- Add a managed domain to a providerremove(rm) - Remove a managed domain from a providerverify- Verify a managed domain
dns-provider domains list (alias: ls)
List managed domains for a provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--json | Output in JSON format | - | No |
dns-provider domains add
Add a managed domain to a provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
-d, --domain <domain> | Domain name | - | Yes |
--auto-manage | Enable auto-management for DNS records | - | No |
dns-provider domains remove (alias: rm)
Remove a managed domain from a provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--provider-id <id> | Provider ID | - | Yes |
-d, --domain <domain> | Domain name | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
dns-provider domains verify
Verify a managed domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--provider-id <id> | Provider ID | - | Yes |
-d, --domain <domain> | Domain name | - | Yes |
dns-provider lookup
Lookup DNS A records for a domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain name to lookup | - | Yes |
--json | Output in JSON format | - | No |
ip-access (alias: ipa)
Manage IP access control rules
Subcommands:
list(ls) - List all IP access control rulescreate(add) - Create a new IP access control ruleshow- Show IP access control rule detailsupdate- Update an IP access control ruleremove(rm) - Delete an IP access control rulecheck- Check if an IP address is blocked
ip-access list (alias: ls)
List all IP access control rules
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
ip-access create (alias: add)
Create a new IP access control rule
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--ip <ip_or_cidr> | IP address or CIDR range (e.g., "192.168.1.1" or "10.0.0.0/24") | - | Yes |
--action <action> | Action to take: "allow" or "deny" | - | Yes |
--description <desc> | Optional description/reason for the rule | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
ip-access show
Show IP access control rule details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Rule ID | - | Yes |
--json | Output in JSON format | - | No |
ip-access update
Update an IP access control rule
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Rule ID | - | Yes |
--ip <ip> | New IP address or CIDR range | - | Yes |
--action <action> | New action: "allow" or "deny" | - | Yes |
--description <desc> | New description/reason | - | Yes |
ip-access remove (alias: rm)
Delete an IP access control rule
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Rule ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
ip-access check
Check if an IP address is blocked
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--ip <ip> | IP address to check | - | Yes |
--json | Output in JSON format | - | No |
audit
View audit logs
Subcommands:
list(ls) - List audit logsshow- Show audit log details
audit list (alias: ls)
List audit logs
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
--limit <n> | Maximum number of logs to return | 50 | Yes |
--offset <n> | Number of logs to skip | - | Yes |
--operation-type <type> | Filter by operation type | - | Yes |
--user-id <id> | Filter by user ID | - | Yes |
--from <timestamp> | Start timestamp (ISO 8601 or epoch ms) | - | Yes |
--to <timestamp> | End timestamp (ISO 8601 or epoch ms) | - | Yes |
audit show
Show audit log details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Audit log ID | - | Yes |
--json | Output in JSON format | - | No |
proxy-logs (alias: plogs)
View proxy request logs and statistics
Subcommands:
list(ls) - List proxy logsshow- Show proxy log detailsby-request- Get proxy log by request IDstats- Get time bucket statistics (last 24 hours)today- Get today's request statistics
proxy-logs list (alias: ls)
List proxy logs
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
--limit <n> | Items per page (default: 20, max: 100) | - | Yes |
--page <n> | Page number | - | Yes |
--project-id <id> | Filter by project ID | - | Yes |
--environment-id <id> | Filter by environment ID | - | Yes |
--method <method> | Filter by HTTP method (GET, POST, etc.) | - | Yes |
--status-code <code> | Filter by HTTP status code | - | Yes |
--host <host> | Filter by host | - | Yes |
--path <path> | Filter by path (partial match) | - | Yes |
--start-date <date> | Start date (ISO 8601) | - | Yes |
--end-date <date> | End date (ISO 8601) | - | Yes |
--sort-by <field> | Sort by field (default: timestamp) | - | Yes |
--sort-order <order> | Sort order: asc or desc (default: desc) | - | Yes |
--is-bot | Filter for bot requests only | - | No |
--has-error | Filter for requests with errors only | - | No |
proxy-logs show
Show proxy log details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Proxy log ID | - | Yes |
--json | Output in JSON format | - | No |
proxy-logs by-request
Get proxy log by request ID
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--request-id <id> | Request ID | - | Yes |
--json | Output in JSON format | - | No |
proxy-logs stats
Get time bucket statistics (last 24 hours)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
proxy-logs today
Get today's request statistics
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
email-domains (alias: edom)
Manage email domains for transactional email
Subcommands:
list(ls) - List all email domainscreate(add) - Create a new email domainshow- Show email domain detailsremove(rm) - Remove an email domainby-name- Look up an email domain by domain namedns-records- Get DNS records for an email domainsetup-dns- Setup DNS records using a configured DNS providerverify- Verify an email domain DNS configuration
email-domains list (alias: ls)
List all email domains
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
email-domains create (alias: add)
Create a new email domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain name (e.g., mail.example.com) | - | Yes |
--provider-id <id> | Email provider ID | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
email-domains show
Show email domain details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Email domain ID | - | Yes |
--json | Output in JSON format | - | No |
email-domains remove (alias: rm)
Remove an email domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Email domain ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
email-domains by-name
Look up an email domain by domain name
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain name | - | Yes |
--json | Output in JSON format | - | No |
email-domains dns-records
Get DNS records for an email domain
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Email domain ID | - | Yes |
--json | Output in JSON format | - | No |
email-domains setup-dns
Setup DNS records using a configured DNS provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Email domain ID | - | Yes |
--dns-provider-id <id> | DNS provider ID to use | - | Yes |
email-domains verify
Verify an email domain DNS configuration
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Email domain ID | - | Yes |
email-providers (alias: eprov)
Manage email providers (SES, Scaleway) for transactional email
Subcommands:
list(ls) - List all email providerscreate(add) - Create a new email providershow- Show email provider detailsremove(rm) - Remove an email providertest- Test an email provider by sending a test email
email-providers list (alias: ls)
List all email providers
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
email-providers create (alias: add)
Create a new email provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-n, --name <name> | Provider name | - | Yes |
-t, --type <type> | Provider type (ses, scaleway) | - | Yes |
-r, --region <region> | Cloud region | - | Yes |
--access-key-id <key> | AWS access key ID (for SES) | - | Yes |
--secret-access-key <secret> | AWS secret access key (for SES) | - | Yes |
--api-key <key> | Scaleway API key | - | Yes |
--project-id <id> | Scaleway project ID | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
email-providers show
Show email provider details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--json | Output in JSON format | - | No |
email-providers remove (alias: rm)
Remove an email provider
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
email-providers test
Test an email provider by sending a test email
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Provider ID | - | Yes |
--from <email> | Sender email address (must be verified) | - | Yes |
--from-name <name> | Sender display name | - | Yes |
incidents (alias: incident)
Manage incidents for status pages and monitoring
Subcommands:
list(ls) - List incidents for a projectcreate(add) - Create a new incidentshow- Show incident detailsupdate-status- Update an incident statusupdates- List status updates for an incidentbucketed- Get bucketed incident data for a project
incidents list (alias: ls)
List incidents for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--status <status> | Filter by status (investigating, identified, monitoring, resolved) | - | Yes |
--environment-id <id> | Filter by environment ID | - | Yes |
--page <n> | Page number | - | Yes |
--page-size <n> | Items per page | - | Yes |
--json | Output in JSON format | - | No |
incidents create (alias: add)
Create a new incident
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
-t, --title <title> | Incident title | - | Yes |
-d, --description <description> | Incident description | - | Yes |
-s, --severity <severity> | Severity level (critical, major, minor) | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
incidents show
Show incident details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Incident ID | - | Yes |
--json | Output in JSON format | - | No |
incidents update-status
Update an incident status
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Incident ID | - | Yes |
-s, --status <status> | New status (investigating, identified, monitoring, resolved) | - | Yes |
-m, --message <message> | Status update message | - | Yes |
incidents updates
List status updates for an incident
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Incident ID | - | Yes |
--json | Output in JSON format | - | No |
incidents bucketed
Get bucketed incident data for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
-i, --interval <interval> | Bucket interval: 5min, hourly, daily (default: hourly) | - | Yes |
--start-time <time> | Start time (ISO 8601) | - | Yes |
--end-time <time> | End time (ISO 8601) | - | Yes |
--environment-id <id> | Filter by environment ID | - | Yes |
--json | Output in JSON format | - | No |
emails (alias: email)
Manage and send emails
Subcommands:
list(ls) - List sent emailssend- Send an emailshow- Show email detailsstats- Get email statisticsvalidate- Validate an email address
emails list (alias: ls)
List sent emails
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
--page <n> | Page number | - | Yes |
--page-size <n> | Items per page | - | Yes |
--status <status> | Filter by status (sent, delivered, failed) | - | Yes |
--domain-id <id> | Filter by domain ID | - | Yes |
--project-id <id> | Filter by project ID | - | Yes |
--from-address <email> | Filter by sender address | - | Yes |
emails send
Send an email
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--to <email> | Recipient email address | - | Yes |
--subject <subject> | Email subject | - | Yes |
--body <body> | Email body | - | Yes |
--from <email> | Sender email address | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
emails show
Show email details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--id <id> | Email ID | - | Yes |
--json | Output in JSON format | - | No |
emails stats
Get email statistics
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
emails validate
Validate an email address
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--email <email> | Email address to validate | - | Yes |
--json | Output in JSON format | - | No |
load-balancer (alias: lb)
Manage load balancer routes
Subcommands:
list(ls) - List load balancer routescreate(add) - Create a load balancer routeshow- Show route detailsupdate- Update a load balancer routeremove(rm) - Delete a load balancer route
load-balancer list (alias: ls)
List load balancer routes
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
load-balancer create (alias: add)
Create a load balancer route
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain for the route | - | Yes |
-t, --target <target> | Target upstream URL | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
load-balancer show
Show route details
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain of the route | - | Yes |
--json | Output in JSON format | - | No |
load-balancer update
Update a load balancer route
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain of the route | - | Yes |
-t, --target <target> | New target upstream URL | - | Yes |
load-balancer remove (alias: rm)
Delete a load balancer route
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-d, --domain <domain> | Domain of the route | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
imports (alias: import)
Import workloads from external sources
Subcommands:
sources(ls) - List available import sourcesdiscover- Discover workloads from a sourceplan- Create an import planexecute- Execute an importstatus- Get import status
imports sources (alias: ls)
List available import sources
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
imports discover
Discover workloads from a source
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-s, --source <source> | Import source | - | Yes |
--json | Output in JSON format | - | No |
imports plan
Create an import plan
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-s, --source <source> | Import source | - | Yes |
-w, --workload <workload> | Workload ID to import | - | Yes |
imports execute
Execute an import
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-s, --source <source> | Import source | - | Yes |
-w, --workload <workload> | Workload ID to import | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
imports status
Get import status
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--session-id <id> | Import session ID | - | Yes |
--json | Output in JSON format | - | No |
migrate
Migrate projects from other platforms (Vercel, Coolify, Dokploy)
Subcommands:
run- Run the full interactive migration wizarddiscover- Discover projects on a source platformplan- Generate a migration plan for a project
migrate run
Run the full interactive migration wizard
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--from <platform> | Source platform (vercel, coolify, dokploy) | - | Yes |
migrate discover
Discover projects on a source platform
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--from <platform> | Source platform (vercel, coolify, dokploy) | - | Yes |
--json | Output in JSON format | - | No |
migrate plan
Generate a migration plan for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--from <platform> | Source platform (vercel, coolify, dokploy) | - | Yes |
--project <id> | Source project ID | - | Yes |
templates (alias: tpl)
Browse deployment templates
Subcommands:
list(ls) - List available templates
templates list (alias: ls)
List available templates
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
--type <type> | Filter by project type (server, static) | - | Yes |
platform (alias: plat)
View platform and server information
Subcommands:
info- Get platform informationaccess- Get access and networking informationprivate-ip- Get the server private IP addresspublic-ip- Get the server public IP address
platform info
Get platform information
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
platform access
Get access and networking information
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
platform private-ip
Get the server private IP address
platform public-ip
Get the server public IP address
presets (alias: preset)
Browse available build presets
Subcommands:
list(ls) - List available presetsshow(get) - Show details for a specific preset
presets list (alias: ls)
List available presets
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
--type <type> | Filter by project type (server, static) | - | Yes |
presets show (alias: get)
Show details for a specific preset
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
funnels (alias: funnel)
Manage analytics funnels for projects
Subcommands:
list(ls) - List all funnels for a projectcreate(add) - Create a new funnel for a projectupdate- Update a funnelremove(rm) - Delete a funnelmetrics- Get funnel metricspreview- Preview funnel metrics without saving
funnels list (alias: ls)
List all funnels for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--json | Output in JSON format | - | No |
funnels create (alias: add)
Create a new funnel for a project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
-n, --name <name> | Funnel name | - | Yes |
-s, --steps <json> | Funnel steps as JSON array (e.g. '[{"event_name":"page_view"},{"event_name":"signup"}]') | - | Yes |
-y, --yes | Skip confirmation prompts (for automation) | - | No |
funnels update
Update a funnel
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--funnel-id <id> | Funnel ID | - | Yes |
-n, --name <name> | New funnel name | - | Yes |
-s, --steps <json> | New funnel steps as JSON array | - | Yes |
funnels remove (alias: rm)
Delete a funnel
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--funnel-id <id> | Funnel ID | - | Yes |
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
funnels metrics
Get funnel metrics
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
--funnel-id <id> | Funnel ID | - | Yes |
--json | Output in JSON format | - | No |
funnels preview
Preview funnel metrics without saving
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--project-id <id> | Project ID | - | Yes |
-s, --steps <json> | Funnel steps as JSON array | - | Yes |
--json | Output in JSON format | - | No |
notification-preferences (alias: notif-prefs)
Manage notification preferences
Subcommands:
show(get) - Show current notification preferencesupdate(set) - Update a notification preferencereset- Reset notification preferences to defaults
notification-preferences show (alias: get)
Show current notification preferences
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
notification-preferences update (alias: set)
Update a notification preference
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-k, --key <key> | Preference key to update | - | Yes |
-v, --value <value> | Value for the preference | - | Yes |
notification-preferences reset
Reset notification preferences to defaults
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-f, --force | Skip confirmation | - | No |
-y, --yes | Skip confirmation prompts (alias for --force) | - | No |
init
Initialize a Temps project in the current directory
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-n, --name <name> | Project name (for new projects) | - | Yes |
-y, --yes | Skip confirmation prompts | - | No |
link
Link current directory to a Temps project
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-e, --environment <name> | Set default environment | - | Yes |
up
Deploy the current project (runs setup wizard if not linked)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug or ID | - | Yes |
-e, --environment <env> | Target environment name | - | Yes |
-b, --branch <branch> | Git branch to deploy (auto-detected from cwd) | - | Yes |
-n, --name <name> | Project name (for new projects) | - | Yes |
--preset <preset> | Framework preset slug (skip auto-detection) | - | Yes |
--manual | Use manual deployment mode (no git) | - | No |
--no-services | Skip external service setup | - | No |
--no-wait | Do not wait for deployment to complete | - | No |
-y, --yes | Skip confirmation prompts | - | No |
status
Show project deployment status
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug | - | Yes |
-e, --environment <env> | Filter by environment | - | Yes |
--json | Output in JSON format | - | No |
instances (alias: instance)
Manage Temps server instances
Subcommands:
list(ls) - List configured instancesadd- Add a new instanceremove(rm) - Remove an instanceswitch(use) - Switch to a different instanceshow- Show instance details (or current instance)
instances list (alias: ls)
List configured instances
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
instances add
Add a new instance
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-n, --name <name> | Instance name | - | Yes |
-u, --url <url> | Instance URL | - | Yes |
instances remove (alias: rm)
Remove an instance
instances switch (alias: use)
Switch to a different instance
instances show
Show instance details (or current instance)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output in JSON format | - | No |
env:pull
Pull environment variables to a .env file
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-e, --environment <name> | Pull from specific environment | - | Yes |
-p, --project <project> | Project slug | - | Yes |
env:push
Push environment variables from a .env file
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-e, --environment <names> | Comma-separated environment names | - | Yes |
-p, --project <project> | Project slug | - | Yes |
--overwrite | Overwrite existing variables | - | No |
rollback
Rollback to a previous deployment
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug | - | Yes |
-e, --environment <env> | Target environment | production | Yes |
--to <id> | Rollback to specific deployment ID | - | Yes |
-y, --yes | Skip confirmation | - | No |
open
Open project URL in browser
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug | - | Yes |
-e, --environment <env> | Open specific environment | - | Yes |
--dashboard | Open the dashboard instead of the project URL | - | No |
exec (alias: ssh)
Execute a command in a running container (coming soon)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug | - | Yes |
-e, --environment <env> | Target environment | - | Yes |
dev
Start a local development tunnel (coming soon)
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
-p, --project <project> | Project slug | - | Yes |
--port <port> | Local port to expose | 3000 | Yes |
cloud
Temps Cloud
Subcommands:
login- Login to Temps Cloudlogout- Logout from Temps Cloudwhoami- Show current Temps Cloud accountvps- Manage cloud VPS instancesbilling- Manage Temps Cloud billing and subscription
cloud login
Login to Temps Cloud
cloud logout
Logout from Temps Cloud
cloud whoami
Show current Temps Cloud account
cloud vps
Manage cloud VPS instances
Subcommands:
list- List VPS instancescreate- Provision a new VPS instanceshow- Show VPS instance details and provisioning logsdestroy- Destroy a VPS instanceretry- Retry failed VPS provisioningcredentials- Show VPS panel credentialsimages- List available OS imageslocations- List available datacenter locationstypes- List available server types with pricing
cloud vps list
List VPS instances
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output as JSON | - | No |
cloud vps create
Provision a new VPS instance
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--image <image> | OS image ID | - | Yes |
--location <location> | Datacenter location ID | - | Yes |
--type <type> | Server type ID | - | Yes |
--json | Output as JSON | - | No |
cloud vps show
Show VPS instance details and provisioning logs
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output as JSON | - | No |
cloud vps destroy
Destroy a VPS instance
cloud vps retry
Retry failed VPS provisioning
cloud vps credentials
Show VPS panel credentials
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output as JSON | - | No |
cloud vps images
List available OS images
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output as JSON | - | No |
cloud vps locations
List available datacenter locations
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output as JSON | - | No |
cloud vps types
List available server types with pricing
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--location <location> | Filter by datacenter location | - | Yes |
--json | Output as JSON | - | No |
cloud billing
Manage Temps Cloud billing and subscription
Subcommands:
overview- Show billing overviewusage- Show usage and limitsupgrade- Upgrade your plan
cloud billing overview
Show billing overview
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output as JSON | - | No |
cloud billing usage
Show usage and limits
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--json | Output as JSON | - | No |
cloud billing upgrade
Upgrade your plan
Options:
| Flag | Description | Default | Required |
|---|---|---|---|
--yearly | Use yearly billing cycle (default: monthly) | - | No |
--no-browser | Don't open browser, just show the URL | - | No |
Examples
Basic Workflow
# Login to Temps
bunx @temps-sdk/cli login
# Create a new project
bunx @temps-sdk/cli projects create --name my-app
# Deploy to production
bunx @temps-sdk/cli deploy --project my-app --environment production
# View deployment logs
bunx @temps-sdk/cli logs --project my-app --follow
# Stream runtime container logs
bunx @temps-sdk/cli runtime-logs --project my-app
# List containers
bunx @temps-sdk/cli containers list --project-id 1 --environment-id 1
Managing Environments
# List environments
bunx @temps-sdk/cli environments list --project my-app
# Set environment variables
bunx @temps-sdk/cli environments vars set --project my-app --key DATABASE_URL --value "postgres://..."
# View environment variables
bunx @temps-sdk/cli environments vars list --project my-app
Managing Domains
# Add a custom domain
bunx @temps-sdk/cli domains add --project my-app --domain app.example.com
# List domains
bunx @temps-sdk/cli domains list --project my-app
# Remove a domain
bunx @temps-sdk/cli domains remove --project my-app --domain app.example.com
Environment Variables
The CLI respects the following environment variables:
| Variable | Description |
|---|---|
TEMPS_API_URL | API endpoint URL |
TEMPS_API_TOKEN | API authentication token |
TEMPS_API_KEY | API key (alternative to token) |
NO_COLOR | Disable colored output |
Configuration
Configuration is stored in:
- Config file:
~/.temps/config.json - Credentials:
~/.temps/.secrets
Use bunx @temps-sdk/cli configure show to view current configuration.
Support
- Documentation: https://temps.dev/docs
- Issues: https://github.com/kfs/temps/issues