Skytells CLI
The Skytells CLI lets you manage your entire Skytells environment from the terminal — deploy apps, provision databases, stream logs, monitor infrastructure, and automate workflows without opening a browser.
The Skytells CLI (@skytells/cli) gives you full terminal-based access to the Skytells platform. Every operation available in the Console is also accessible from the command line, with machine-readable JSON output built in for scripting and CI/CD.
What you can do
Deploy apps
Trigger deployments, redeploy on demand, and stream deployment logs in real time.
Manage databases
Provision PostgreSQL, MySQL, MariaDB, MongoDB, and Redis instances in seconds.
Provision cloud
Deploy general-purpose and GPU compute instances (H100, A100) across global regions.
Observe and debug
Stream live logs, check project status, and query Cognition for errors, anomalies, and security events.
Automate workflows
Integrate deployments into CI/CD pipelines using environment variables and --json output.
Orchestrate
Monitor and inspect Orchestrator workflows and executions directly from the terminal.
CLI vs Console vs API
All three interfaces target the same Skytells platform. Choose the right tool for each task:
| Task | CLI | Console | API |
|---|---|---|---|
| Deploy an app | ✓ | ✓ | ✓ |
| Stream live logs | ✓ | — | — |
| CI/CD automation | ✓ | — | ✓ |
| Script and pipe output | ✓ | — | ✓ |
| Configure billing | — | ✓ | — |
| Manage API keys | — | ✓ | — |
| Browse model catalog | — | ✓ | — |
| Interactive model testing | — | ✓ | — |
| Custom integration | — | — | ✓ |
| Webhook-driven automation | — | — | ✓ |
Use the CLI when you want terminal access, scripting, or CI/CD integration. Use the Console for billing, account management, and the Playground. Use the API for custom integrations.
Quick start
Install
npm install -g @skytells/cliAuthenticate
skytells loginThis opens a browser authorization page. Approve access, and the CLI stores your credentials.
Link a project
skytells link sk_proj_your_access_key_hereCopy the access key from your project's Settings page in the Console.
Run your first command
skytells statusWhat's next
Install
Supported platforms, installation methods, version requirements, and how to update.
Authenticate
Login flows, personal access tokens, environment variables, and token scopes.
Core Workflows
Task-oriented guides for deploying projects, managing resources, and monitoring.
Command Reference
All commands organized by product domain — auth, apps, databases, cloud, and more.
How is this guide?