---
title: blossom update
url: "/docs/reference/cli/update/"
canonical_url: https://docs.blossom88.com/docs/reference/cli/update/
markdown_url: https://docs.blossom88.com/docs/reference/cli/update.md
summary: Update the installed Blossom CLI
categories:
- cli
- reference
---

# blossom update

Update the installed Blossom CLI

## Usage

    blossom update [--check] [--version VERSION] [--mode MODE]

## Flags

| Flag | Description |
| --- | --- |
| `--check` | Check for an update without installing |
| `--version` | Install a specific release, including an older version |
| `--mode` | Save automatic update behavior: notify, auto, or off |

Update the Blossom CLI installed by the official installer:

    blossom update
    blossom update --check

Release installations check at most once every 24 hours after a successful
interactive text command and print an update notice to stderr. Checks have a
two-second deadline; offline checks do not affect your command's exit status.

Choose the behavior for this installation:

    blossom update --mode auto
    blossom update --mode notify
    blossom update --mode off

`notify` is the default. `auto` installs after a successful interactive command,
with a 30-second deadline. `off` disables automatic checks. Setting
`BLOSSOM_UPDATE=notify`, `auto`, or `off` overrides the saved mode for that process.
Explicit `blossom update` and `--check` still work when automatic checks are off.

Automatic checks skip CI, pipes, JSON output, help, completion, MCP, version,
skill installation, and source builds. Updates keep the installation's release
channel; saved API profiles do not select or change that channel.

Downloads use HTTPS and the release's SHA-256 checksum. The updater verifies
the candidate binary before replacing the existing executable atomically;
the next invocation uses the new version. Concurrent updates are serialized.

The latest release is installed only when its release timestamp is newer than
the running build. To deliberately install a specific release or roll back:

    blossom update --version v2026.11.09-dev.1

Use your original install method for source or package-manager installations.
Older releases without updater support need one more run of the installer.
