celesto update

celesto update upgrades your installed Celesto to the latest stable release from PyPI. You don’t need to remember whether you installed Celesto with pip or as a uv tool — the command detects how you installed it and runs the matching upgrade for you. Run it any time you want to pick up the newest release, or use --check first to see whether an update is available before installing it.

Synopsis

celesto update [OPTIONS]

Options

flag

default:"false"

Report whether an update is available without installing it. Exits successfully whether you’re up to date or behind.

flag

default:"false"

Emit machine-readable JSON instead of formatted text. Useful for scripts and automation.

Examples

Check for an update

See whether a newer release is available without changing anything:

celesto update --check

Example output when an update is available:

Update available: 0.0.14 → 0.0.15. Run celesto update to install.

Example output when you’re already up to date:

celesto 0.0.15 is up to date.

Upgrade to the latest release

Run the upgrade. Celesto picks the right package manager based on how it was installed:

celesto update

If you installed Celesto with uv tool install celesto, this runs uv tool upgrade celesto. Otherwise it runs pip install --upgrade celesto. Output from the underlying package manager streams live to your terminal.

JSON output for automation

Get a structured response you can parse from a script:

celesto update --json

The response includes the previous version, the version now installed, whether an upgrade happened, and the raw output from the underlying package manager:

{
  "command": "update",
  "exit_code": 0,
  "data": {
    "previous": "0.0.14",
    "current": "0.0.15",
    "upgraded": true,
    "pip_output": "..."
  }
}

Combine --check and --json to script update detection:

celesto update --check --json | jq '.data.update_available'

The check response includes current, latest, and an update_available boolean.

How install detection works

celesto update looks for celesto in the list returned by uv tool list. If it’s there, the upgrade goes through uv. Otherwise it falls back to pip install --upgrade celesto running under the same Python interpreter that started the CLI. If the upgrade fails (for example, because the network is unreachable), Celesto prints a recovery command you can run manually:

pip install --upgrade celesto

Exit codes

Code	Description
`0`	Success — already up to date, update available (with `--check`), or upgrade completed
`1`	Upgrade failed, or the installed version could not be determined

celesto prune — reclaim disk space from older releases after an upgrade
celesto doctor — verify your install after an upgrade

Celesto CLI

Celesto API

Celesto CLI

Agentor API

Synopsis

Options

Examples

Check for an update

Upgrade to the latest release

JSON output for automation

How install detection works

Exit codes

​Synopsis

​Options

​Examples

​Check for an update

​Upgrade to the latest release

​JSON output for automation

​How install detection works

​Exit codes

​Related commands

Synopsis

Options

Examples

Check for an update

Upgrade to the latest release

JSON output for automation

How install detection works

Exit codes

Related commands