Skip to content
Ironflow is pre-1.0: APIs can change between releases. Pin a version. What is ready →

ironflow update

Check whether a newer Ironflow release is available.

Make one request to the public release mirror and compare the latest release with this binary. The command prints the current and latest versions, the release notes URL, and the download URL for your OS and architecture. It does not download or replace anything, because a package manager may own the binary.

Terminal window
ironflow update check

This is the only command that contacts the release mirror, and only when you run it. If the request fails, the command prints the error on stderr and exits non-zero: 3 when it cannot reach the mirror (connection, DNS or the 10-second timeout), 1 for any other failure, such as a non-200 reply. When this binary is current or newer, the command prints You are up to date. and stops. A development build (dev) has no comparable version, so the command prints This build (dev) has no comparable version. instead of a verdict, followed by the release links.

Output:

Current: 0.38.0
Latest: v0.39.0
A newer release is available.
Release notes: https://github.com/sahina/ironflow-releases/releases/tag/v0.39.0
Download: https://github.com/sahina/ironflow-releases/releases/download/v0.39.0/ironflow_0.39.0_darwin_arm64.tar.gz
Upgrade: brew upgrade ironflow, or download the archive above and replace the binary

The server sends its version in the X-Ironflow-Version header of authenticated responses. When a CLI command receives a response whose version differs from the CLI version, the CLI prints one warning on stderr and continues. The check adds no requests. A dev build on either side never warns.

Warning: ironflow CLI 0.38.0 is out of step with server 0.39.0.
Run 'ironflow update check' for upgrade options.