Skip to main content

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:

Shell
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.

PowerShell
$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:

Shell
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