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 option | Meaning |
|---|---|
--check | Compare 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.