CLI Commands

Full reference for all Skytells CLI commands, grouped by resource. Every command supports --json for machine-readable output.

Global flags

These flags work with every command:

Flag	Description
`--json`	Output as JSON (for scripting and CI/CD)
`--help`	Show usage for the command
`--version`	Show CLI version

Authentication

Commands for managing your session and credentials.

Authenticate with Skytells. Uses the device flow by default.

skytells login [--token] [--scopes <scopes>]

Flag	Description
`--token`	Authenticate with a personal access token (non-interactive)
`--scopes <scopes>`	Comma-separated list of scopes to request

# Device flow (browser)
skytells login

# Token-based
skytells login --token

# Request specific scopes
skytells login --scopes inference,projects.read,deployments.write

`skytells logout`

Remove stored credentials.

skytells logout [--force]

Flag	Description
`--force`	Skip confirmation prompt

`skytells whoami`

Display your authenticated user information.

skytells whoami [--json]

`skytells link`

Link a project access key to the current user session.

skytells link <access-key>

Argument	Description
`access-key`	Project access key (`sk_proj_*`)

skytells link sk_proj_your_access_key_here

Projects

`skytells projects ls`

List all projects you have access to.

skytells projects ls [--type <type>] [--json]

Flag	Description
`--type <type>`	Filter by project type

`skytells projects add`

Create a new project.

skytells projects add <name> [--type <type>] [--json]

Argument	Description
`name`	Project name

Flag	Description
`--type <type>`	Project type (e.g., `production`, `staging`)

skytells projects add my-project
skytells projects add staging-env --type staging

`skytells project`

View the linked project.

skytells project [--json]

`skytells project set`

Update a setting on the linked project.

skytells project set <field> <value> [--json]

Field	Description	Values
`name`	Project name	any string
`description`	Project description	any string
`network_mode`	Network access mode	`public`, `private`

skytells project set name "New Name"
skytells project set network_mode private

Apps

Manage apps in the linked project.

`skytells apps ls`

List all apps.

skytells apps ls [--json]

`skytells apps add`

Create an app.

skytells apps add <name> [--type <type>] [--json]

Argument	Description
`name`	App name

Flag	Description
`--type <type>`	App type (e.g., `web`, `worker`)

skytells apps add my-api
skytells apps add my-frontend --type web

`skytells apps inspect`

Show detailed information about an app.

skytells apps inspect <id> [--json]

`skytells apps set`

Update a setting on an app.

skytells apps set <id> <field> <value> [--json]

skytells apps set abc123 name "Renamed App"

`skytells apps rm`

Delete an app permanently.

skytells apps rm <id> [-f, --force] [--json]

This action cannot be undone.

App lifecycle

Command	Description
`skytells apps start <id>`	Start a stopped app
`skytells apps stop <id>`	Stop a running app
`skytells apps restart <id>`	Restart a running app
`skytells apps redeploy <id>`	Redeploy with current configuration

All accept --force and --json.

Deployments

Deploy and inspect deployment history.

`skytells deploy`

Trigger a deployment for an app.

skytells deploy <app> [--json]

Argument	Description
`app`	App ID or slug

skytells deploy my-api
skytells deploy abc123 --json

`skytells deployments ls`

List deployment history.

skytells deployments ls [--app <id>] [--limit <n>] [--offset <n>] [--json]

Flag	Description
`--app <id>`	Filter by app
`--limit <n>`	Maximum results
`--offset <n>`	Skip N results (pagination)

Databases

Provision and manage databases.

`skytells databases ls`

List all databases.

skytells databases ls [--json]

`skytells databases add`

Create a database.

skytells databases add <name> <type> [options] [--json]

Argument	Description
`name`	Database name
`type`	Engine: `postgres`, `mysql`, `mariadb`, `mongo`, `redis`

Flag	Description
`--docker-image <image>`	Custom Docker image
`--description <desc>`	Description
`--password <pass>`	Database password
`--db-name <name>`	Database name within the engine
`--db-user <user>`	Database user

skytells databases add production-db postgres
skytells databases add session-cache redis
skytells databases add production-db postgres \
  --description "Main production database" \
  --password "secure-password" \
  --db-name app_production \
  --db-user app_user

`skytells databases inspect`

Show detailed database information.

skytells databases inspect <id> [--json]

`skytells databases set`

Update a database setting.

skytells databases set <id> <field> <value> [--json]

Field	Description
`name`	Rename the database
`description`	Update description
`backup_enabled`	Enable/disable backups (`true`/`false`)
`backup_schedule`	Cron expression for backup schedule
`external_port`	External access port

`skytells databases rm`

Permanently delete a database.

skytells databases rm <id> [-f, --force] [--json]

This action is irreversible. All data will be lost.

Database lifecycle

Command	Description
`skytells databases start <id>`	Start a stopped database
`skytells databases stop <id>`	Stop a running database
`skytells databases deploy <id>`	Apply configuration and start

All accept --force and --json.

Environment variables

Configure environment variables for apps and projects.

`skytells env ls`

List environment variables.

skytells env ls [--app <id>] [--json]

Flag	Description
`--app <id>`	Scope to a specific app (omit for project-level)

`skytells env set`

Set one or more environment variables.

skytells env set <KEY=value> [<KEY=value>...] [--app <id>] [--json]

# Single variable
skytells env set NODE_ENV=production

# Multiple variables
skytells env set API_KEY=abc123 NODE_ENV=production PORT=3000

# App-scoped
skytells env set --app abc123 DATABASE_URL=postgres://...

Domains

Manage custom domains.

`skytells domains ls`

List all custom domains.

skytells domains ls [--json]

`skytells domains add`

Add a custom domain.

skytells domains add <domain> [--app <id>] [--json]

skytells domains add api.example.com
skytells domains add api.example.com --app abc123

`skytells domains rm`

Remove a custom domain.

skytells domains rm <id> [-f, --force] [--json]

Logs & status

Monitor running apps.

`skytells status`

Display project status including all apps and their state.

skytells status [--json]

`skytells logs`

Stream or view logs from an app.

skytells logs <app> [--type <type>] [--deployment <id>] [--tail <n>] [--follow] [--json]

Flag	Description
`--type <type>`	`container` (default) or `deployment`
`--deployment <id>`	Filter by a specific deployment
`--tail <n>`	Number of recent lines to show
`--follow`	Stream logs in real time

# Recent logs
skytells logs my-api

# Stream live
skytells logs my-api --follow

# Deployment logs
skytells logs my-api --type deployment --follow

# Last 100 lines
skytells logs my-api --tail 100

Cloud infrastructure

Deploy and manage cloud instances. See skytells.ai/infrastructure for available regions, GPU plans, and pricing.

`skytells cloud ls`

List all cloud instances.

skytells cloud ls [--json]

`skytells cloud deploy`

Deploy a new cloud compute instance.

skytells cloud deploy [options] [--json]

Flag	Description
`--region <region>`	Deployment region (e.g., `ewr`, `lax`, `fra`)
`--plan <plan>`	Instance plan (e.g., `vc2-1c-1gb`, `gpu-h100-1`)
`--os <id>`	Operating system ID
`--label <label>`	Human-readable label
`--hostname <name>`	Hostname
`--tags <tags>`	Comma-separated tags
`--firewall-group <id>`	Firewall group ID
`--vpc <id>`	VPC ID
`--ipv6`	Enable IPv6 networking

# General instance
skytells cloud deploy \
  --region ewr \
  --plan vc2-2c-4gb \
  --os 387 \
  --label "api-server"

# NVIDIA H100 GPU instance
skytells cloud deploy \
  --region ewr \
  --plan gpu-h100-1 \
  --os 387 \
  --label "h100-training"

# NVIDIA A100 GPU instance
skytells cloud deploy \
  --region lax \
  --plan gpu-a100-1 \
  --os 387 \
  --label "a100-inference"

`skytells cloud inspect`

Show instance details.

skytells cloud inspect <id> [--json]

`skytells cloud destroy`

Permanently destroy an instance.

skytells cloud destroy <id> [-f, --force] [--json]

This action cannot be undone. All instance data will be lost.

Cloud lifecycle

Command	Description
`skytells cloud start <id>`	Start a halted instance
`skytells cloud halt <id>`	Halt (stop) a running instance
`skytells cloud reboot <id>`	Reboot a running instance

All accept --force and --json.

Orchestrator

Manage Orchestrator workflows and executions.

`skytells workflows ls`

List all workflows.

skytells workflows ls [--json]

`skytells orchestrator overview`

Show orchestrator health and summary.

skytells orchestrator overview [--json]

`skytells orchestrator executions`

List workflow executions.

skytells orchestrator executions [--workflow <id>] [--status <status>] [--limit <n>] [--offset <n>] [--json]

Flag	Description
`--workflow <id>`	Filter by workflow
`--status <status>`	Filter by status (`completed`, `failed`, `running`)
`--limit <n>`	Maximum results
`--offset <n>`	Pagination offset

`skytells orchestrator inspect`

Show execution details.

skytells orchestrator inspect <id> [--json]

`skytells orchestrator metrics`

View execution metrics over a time period.

skytells orchestrator metrics [--from <date>] [--to <date>] [--json]

skytells orchestrator metrics --from 2026-01-01 --to 2026-01-31

`skytells orchestrator usage`

Show orchestrator resource usage.

skytells orchestrator usage [--from <date>] [--to <date>] [--json]

Cognition

Query Cognition observability data.

`skytells cognition overview`

Show application health summary.

skytells cognition overview [--project <id>] [--hours <n>] [--json]

skytells cognition overview --hours 24

`skytells cognition errors`

List application errors.

skytells cognition errors [--project <id>] [--limit <n>] [--offset <n>] [--json]

`skytells cognition security`

List security events.

skytells cognition security [--project <id>] [--limit <n>] [--offset <n>] [--json]

`skytells cognition runtime`

View runtime performance snapshots.

skytells cognition runtime [--project <id>] [--limit <n>] [--offset <n>] [--json]

`skytells cognition anomalies`

List detected anomalies.

skytells cognition anomalies [--project <id>] [--limit <n>] [--offset <n>] [--json]

`skytells cognition events`

List real-time events. Supports incremental polling via --since.

skytells cognition events [--project <id>] [--limit <n>] [--since <id>] [--json]

# Latest events
skytells cognition events --limit 50

# Poll for new events since a specific event
skytells cognition events --since evt-100 --json

`skytells cognition timeseries`

View time-series metrics (request rates, error rates, latency).

skytells cognition timeseries [--project <id>] [--hours <n>] [--json]

# Last 24 hours
skytells cognition timeseries --hours 24

# Last 7 days
skytells cognition timeseries --hours 168

How is this guide?

On this page