macOS installer cannot succeed from releases; /cli route is not CLI-only

[manuschillerdev]

Summary

The documented macOS install path does not currently produce a usable hypeman command.

curl -fsSL https://get.hypeman.sh | bash attempts the full server install on macOS, but the release artifacts it expects are not published. https://get.hypeman.sh/cli also redirects to the same full server installer instead of a CLI-only installer.

Reproduction

On Apple Silicon macOS:

curl -fsSL https://get.hypeman.sh | bash
command -v hypeman

Expected:

hypeman

Actual:

hypeman not found

Also:

curl -fsSLI https://get.hypeman.sh/cli

currently redirects to the full installer:

https://raw.githubusercontent.com/onkernel/hypeman/refs/heads/main/scripts/install.sh

What appears to be happening

In release mode on macOS, scripts/install.sh searches for a server release artifact shaped like:

hypeman_<version>_darwin_arm64.tar.gz

Current kernel/hypeman server releases appear to publish Linux artifacts only, for example:

hypeman_0.1.0_linux_amd64.tar.gz
hypeman_0.1.0_linux_arm64.tar.gz

Because the server install fails before CLI setup completes, the user ends up without hypeman in PATH.

Separately, /cli does not seem to be CLI-only; it returns the same full installer and therefore has the same failure mode.

Suggested fixes

• Publish macOS server artifacts, or make macOS default to source build.
• Make https://get.hypeman.sh/cli install only kernel/hypeman-cli.
• Let CLI installation succeed even if server installation is unavailable.
• Avoid requiring Docker CLI unconditionally on macOS if Docker is only needed for build features.
• Update the README with the currently supported macOS install path.

[jarugupj]

Fixed in v0.1.1 — both halves of the original report:

1. /cli is now CLI-only. It no longer falls through to the full server installer; it redirects to a dedicated CLI-only installer (scripts/install-cli.sh, Add CLI-only install script (scripts/install-cli.sh) #281):

curl -fsSLI https://get.hypeman.sh/cli → 307 → .../scripts/install-cli.sh
Pulls only the hypeman CLI from kernel/hypeman-cli — no server / Docker / codesign, and works on Linux + macOS (incl. Intel).

2. macOS server install now works. The release now builds + publishes hypeman__darwin_arm64.tar.gz on a macOS arm64 runner (Publish darwin_arm64 server release artifact #282). Previously the pipeline shipped Linux-only, which is why the installer aborted on Apple Silicon looking for a missing artifact.

Verified on real Apple Silicon (v0.1.1): artifact published + reachable, correct contents (hypeman-api / hypeman-token / config.example.darwin.yaml, valid arm64 Mach-O), and the server boots clean — Hypervisor access verified type=Virtualization.framework, API on :8080.

Closing as resolved. ✅