Install the Hyfens CLI
Install the released hyfens command and confirm its version. This check does not sign in or connect to a control plane.
Applicability
- Release: Hyfens CLI v0.1.10, checked 24 September 2026.
- Archives: macOS, Linux, and Windows on x64 or arm64.
- Requirements: No Dart or Flutter installation is needed for a native CLI archive.
- Service access: Not required to install or print the CLI version.
macOS or Linux
The installer supports macOS and Linux on x64 and arm64. It downloads the selected GitHub Release archive and checksum file, verifies the archive before extraction, and prints any required PATH guidance. The installer does not modify project files or shell startup files.
Pin the published version rather than resolving a floating release:
curl --fail --silent --show-error --location \
--proto '=https' --proto-redir '=https' --tlsv1.2 \
https://raw.githubusercontent.com/hyfens-hq/hyfens/v0.1.10/scripts/install-hyfens.sh \
| bash -s -- --version v0.1.10
If the installer prints a PATH export, apply it in the current shell as instructed. No sudo is required by the documented installer.
Windows PowerShell
Choose x64 or arm64 to match the machine. This downloads the release archive and checksum, compares their SHA-256 values, and then extracts the bundle under your local application data directory.
$version = "0.1.10"
$architecture = "arm64" # Use "x64" for an x64 machine.
$archive = "hyfens-$version-windows-$architecture.zip"
$base = "https://github.com/hyfens-hq/hyfens/releases/download/v$version"
$root = "$env:LOCALAPPDATA\Hyfens\$version"
New-Item -ItemType Directory -Force -Path $root | Out-Null
Invoke-WebRequest "$base/$archive" -OutFile "$root\$archive"
Invoke-WebRequest "$base/SHA256SUMS" -OutFile "$root\SHA256SUMS"
$checksumLine = Select-String -Path "$root\SHA256SUMS" -SimpleMatch $archive
if (-not $checksumLine) { throw "No checksum found for $archive" }
$expected = (($checksumLine.Line -replace '\s+.*$', '')).ToLowerInvariant()
$actual = (Get-FileHash "$root\$archive" -Algorithm SHA256).Hash.ToLowerInvariant()
if ($actual -ne $expected) { throw "Checksum mismatch for $archive" }
Expand-Archive "$root\$archive" -DestinationPath $root -Force
$env:Path = "$root\hyfens-$version-windows-$architecture\bin;$env:Path"
hyfens.exe --version
The PATH change above lasts only for the current PowerShell process. Follow your organization’s normal process if you want to make a persistent PATH change.
Confirm the installed version
Run:
hyfens --version
Expected output identifies version 0.1.10. If the shell cannot find the command, apply the installer's printed PATH instruction or open a new shell after adding the installation bin directory to PATH.
Continue
- Review the CLI command reference.
- Learn the baseline and patch boundary before preparing app changes.
- For a self-hosted control plane, follow the canonical v0.1.10 installation and upgrade guide.
Validation limit: The install procedure is derived from the v0.1.10 distribution guide. It has not been run against a customer machine as part of this documentation build. No account login or production service was used to verify it.