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 isn’t 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	Prints brew upgrade reoclo/tap/reoclo and exits.
npm	Prints npm i -g @reoclo/cli@latest and exits.
Curl / direct binary	(Coming soon) atomic binary replacement. For now, re-run the install script.

This delegates to whichever package manager owns the binary so you don’t 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.