Upgrading the CLI

The CLI ships on three channels:

Channel	Purpose	Stability
stable	Default for brew, curl, npm.	Tested across all six target platforms.
beta	Pre-release builds for early validation.	May contain unreleased features.
dev	Build-of-the-day from main.	No stability guarantee.

Check what you have

reoclo upgrade --check

Prints the currently installed version and the latest version on the stable channel without making any changes.

Automatic update checks

The CLI checks for a newer stable release on its own: at most once a day, in a background process that never slows your command down. When a newer version is available it prints a single line to stderr pointing at the right upgrade command for how you installed it:

⚡ reoclo 0.49.0 available (you have 0.48.0) — brew upgrade reoclo/tap/reoclo

The notice goes to stderr (so it never corrupts piped or -o json output) and is shown at most once a day. It is automatically suppressed when output is not a terminal, with -o json / -o yaml, under --quiet, and in CI (automation-key auth). Disable it explicitly with either:

export REOCLO_NO_UPDATE_CHECK=1   # for a shell / environment
reoclo servers ls --no-update-check   # for one command

Self-update

reoclo upgrade

Behavior depends on how you installed the CLI:

Install method	What reoclo upgrade does
Homebrew	Runs brew upgrade reoclo/tap/reoclo for you. If brew is missing or fails, it prints the command and exits 1.
npm / pnpm / yarn	Runs the manager’s global install of the target version. Same fallback when the manager is missing or fails.
mise / asdf	Prints the install and use commands.
Curl / direct binary	Replaces the binary in place and keeps the previous binary next to it.

This delegates to whichever package manager owns the binary so you do not end up with mismatched versions across channels.

Switch channels

reoclo upgrade --channel beta

For curl installs, the --channel flag affects which version pointer is fetched from https://get.reoclo.com/cli/<channel>.

For Homebrew and npm installs, channel selection is handled by the formula or package. The flag is ignored with a hint.

Pin to a specific version

Curl install with --version:

curl -sSL https://get.reoclo.com/cli | bash -s -- --version v0.9.0

npm install with a tag:

npm i -g @reoclo/[email protected]

Homebrew does not support arbitrary version pinning out of the box. Use brew install reoclo/tap/[email protected] if a versioned formula exists, or fall back to curl/npm.

Verifying a release

Each release publishes a SHA256SUMS file alongside the binaries on GitHub. The curl installer verifies checksums automatically. For direct binary installs:

curl -sSLO https://github.com/reoclo/cli/releases/download/v0.9.0/reoclo-linux-x64
curl -sSLO https://github.com/reoclo/cli/releases/download/v0.9.0/SHA256SUMS
grep reoclo-linux-x64 SHA256SUMS | shasum -a 256 -c -

Release notes

Release notes live on the GitHub releases page. Subscribe with gh release watch reoclo/cli or your usual GitHub release feed.