Documentation

CLI reference / Binary and models

cumaru upgrade

Replace the global cumaru binary with the latest release, or check freshness.

Synopsis

cumaru upgrade [--check]

Arguments and options

Argument or optionMeaning
--checkCompare the installed version with the latest release tag. Installs nothing.

Side effects

  • Writes: Bare upgrade replaces /usr/local/bin/cumaru (sudo only when needed) and records ~/.config/cumaru.json. It never touches a project.
  • Network: Reads release tags with git ls-remote and downloads the release asset.

Behavior

  • Bare upgrade installs the latest tag even when the running build is newer. Run --check first.
  • A Homebrew install rejects bare upgrade; run brew upgrade rntgspr/tap/cumaru.
  • A failed download, unsupported platform, or version mismatch leaves the existing binary in place.

Example

cumaru upgrade --check

Failures

  • --check: exit 1 with "cannot check" when tags, Git, or network are unavailable. behind and up to date both exit 0.

Sources: docs/upgrade.md; cumaru upgrade --help of CLI 0.15.3.

Back to all commands