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:
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 July 4, 2026
