CLI Reference
mayfly update
Check for newer releases on GitHub and interactively prompt to update the local MayFly binary.
Zero Auto-Updates / Strict User Consent
MayFly never updates in the background without your explicit permission. The update command checks GitHub release tags, compares semantic versions, displays release notes, and requests confirmation before downloading or replacing binaries.
Synopsis
# Check and interactively prompt to update if a newer version exists
mf update
mayfly update
# Check release status without updating
mf update --check
# Automatically accept update prompt (ideal for non-interactive scripts)
mf update --yesDescription
The update command queries the GitHub Releases API for the latest release:
- Compares the remote tag (e.g.
v0.0.6) with the local binary version (v0.0.5) using strict semantic versioning (major.minor.patch). - If your version is up to date, it displays:
[OK] MayFly is up to date (v0.0.5 is the latest release). - If a higher release version exists, it displays the release notes, download URL, and asks for your confirmation:
A newer release of MayFly is available: Current: v0.0.5 Latest: v0.0.6 Release Notes: - Enhanced process isolation - Performance improvements Would you like to update to v0.0.6 now? [y/N]: - If confirmed (
y), it safely downloads the verified platform binary, replacesmayflyandmfin your PATH, and verifies execution.
Options & Flags
| Flag | Shorthand | Description |
|---|---|---|
--check | -c | Only check if an update is available without prompting to install |
--yes | -y | Automatically accept the update confirmation prompt |
-h, --help | Show update command help and options |