Commands Overview

The Skytells CLI is organized by product domain — each group of commands maps directly to a section of the Skytells Console. Every command accepts --json for machine-readable output.

Global flags

These flags are available on every command.

Flag	Description
`--json`	Output as JSON. Use for scripting and CI/CD.
`--help`	Show usage and flags for the command.
`--version`	Print the installed CLI version.

Command domains

Auth

login · logout · whoami · link — manage your session and project credentials.

Projects

projects ls · projects add · project · project set — list, create, and configure projects.

Apps

apps · deploy · deployments · logs · status — full app lifecycle.

Databases

databases — provision PostgreSQL, MySQL, MariaDB, MongoDB, and Redis.

Environment

env ls · env set — manage environment variables at project and app scope.

Domains

domains ls · domains add · domains rm — manage custom domains.

Cloud

cloud — deploy and manage cloud instances including NVIDIA H100/A100 GPU infrastructure.

Orchestrator

workflows · orchestrator — inspect and monitor automated workflows.

Cognition

cognition — query errors, security events, runtime snapshots, and anomalies.

Quick reference

A flat view of all available commands:

Authentication
  skytells login [--token] [--scopes <scopes>]
  skytells logout [--force]
  skytells whoami
  skytells link <access-key>

Projects
  skytells projects ls [--type <type>]
  skytells projects add <name> [--type <type>]
  skytells project
  skytells project set <field> <value>

Apps
  skytells apps ls
  skytells apps add <name> [--type <type>]
  skytells apps inspect <id>
  skytells apps set <id> <field> <value>
  skytells apps rm <id> [-f]
  skytells apps start <id>
  skytells apps stop <id> [-f]
  skytells apps restart <id>
  skytells apps redeploy <id>

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

Logs & Status
  skytells status
  skytells logs <app> [--type <type>] [--tail <n>] [--follow]

Databases
  skytells databases ls
  skytells databases add <name> <type> [options]
  skytells databases inspect <id>
  skytells databases set <id> <field> <value>
  skytells databases rm <id> [-f]
  skytells databases start <id>
  skytells databases stop <id> [-f]
  skytells databases deploy <id>

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

Domains
  skytells domains ls
  skytells domains add <domain> [--app <id>]
  skytells domains rm <id> [-f]

Cloud
  skytells cloud ls
  skytells cloud deploy [options]
  skytells cloud inspect <id>
  skytells cloud destroy <id> [-f]
  skytells cloud start <id>
  skytells cloud halt <id> [-f]
  skytells cloud reboot <id>

Orchestrator
  skytells workflows ls
  skytells orchestrator overview
  skytells orchestrator executions [--workflow <id>] [--status <s>]
  skytells orchestrator inspect <id>
  skytells orchestrator metrics [--from <date>] [--to <date>]
  skytells orchestrator usage [--from <date>] [--to <date>]

Cognition
  skytells cognition overview [--hours <n>]
  skytells cognition errors [--limit <n>]
  skytells cognition security [--limit <n>]
  skytells cognition runtime [--limit <n>]
  skytells cognition anomalies [--limit <n>]
  skytells cognition events [--since <id>] [--limit <n>]
  skytells cognition timeseries [--hours <n>]

How is this guide?