Skip to main content
The celesto CLI lets you manage Celesto from your terminal. Use it for one-off sandbox work, scripts, and debugging SDK workflows.

​
Install and sign in

Install or upgrade the CLI:
Save your API key once:
Check or remove the saved key later:

​
Create your first computer

Create a computer with the default scratch template. The command prints a generated name. Use that name in later commands.
Inspect the computer by name or ID:
List your computers:
Run a command inside the computer:
Open an interactive terminal. SSH means an interactive shell connection to the computer.
Stop and start the same computer when you want to keep its files for later:
Delete the computer when you are done:

​
Computer commands

​
Templates and resources

List templates when you want a computer with tools already installed:
Create a computer from a template:
Override the template’s default CPU, memory, or disk size when the job needs more room:

​
Port commands

Publish a port when a process inside the computer needs a public HTTPS URL:
List published ports:
Unpublish the port when you are done:
A computer can have up to four ports published at a time, and Celesto system ports are reserved for the platform.

​
Auto-resume stopped computers

The run and ssh commands automatically resume a stopped computer before executing. You can run a command or open a terminal session without calling start first.

​
JSON output

Most computer commands support --json or -j for structured output. Use JSON in scripts and automation.
celesto computer ssh is interactive and does not support JSON output.

​
Update command

Run celesto update to upgrade the celesto package in your current Python environment.
The command upgrades celesto using pip when it is available, and falls back to uv when you installed Celesto with uv or are running inside a uv run environment. If neither pip nor uv is available, the command prints the exact command to run yourself, for example:
Last modified on August 9, 2026