Install

Use Homebrew for normal installs on macOS and Linux. Use the packaged release scripts when you need to verify a tarball by hand or install into a custom prefix.

Install with Homebrew

The formula is the released CLI path.

brew tap gethasp/tap
brew install gethasp/tap/hasp
hasp version

If you already added the tap, brew install gethasp/tap/hasp is enough. If hasp version still prints an older version after Homebrew upgrades, another install is earlier on your shell's PATH. Run:

which -a hasp

Remove the older binary, or move Homebrew's bin directory earlier in PATH, then run hash -r in open shells before checking hasp version again.

After install, continue with After Install:

hasp setup

Install with the script

Use the hosted script when you want the current signed release without adding the Homebrew tap:

curl -fsSL https://gethasp.com/install.sh | sh

The script prints each install phase, verifies signed release metadata and artifacts, installs hasp to $HOME/.local/bin/hasp by default, then prints the installed version. In an interactive terminal it asks whether to start hasp setup immediately; the default answer is yes.

For automation, set HASP_INSTALL_RUN_SETUP=0 to skip the prompt or HASP_INSTALL_RUN_SETUP=1 to start setup without asking.

Upgrade with Homebrew

brew update
brew upgrade hasp
hasp version

Run hasp doctor after upgrading if a daemon is already running. It reports CLI and daemon version mismatch.

Uninstall with Homebrew

brew uninstall hasp

Homebrew removes the formula files. It does not remove your HASP vault, HASP_HOME, repo hooks, app launchers, or audit history. Remove those only when you are intentionally decommissioning the local install.

Direct packaged release

Use this path when you downloaded a release tarball and want local signature verification before install:

scripts/hasp-verify-release.sh dist/release/hasp_<version>_<os>_<arch>.tar.gz
scripts/hasp-install-release.sh --verify dist/release/hasp_<version>_<os>_<arch>.tar.gz

Default install prefix:

$HOME/.local/share/hasp/hasp_<version>_<os>_<arch>

Installed binary:

$HOME/.local/share/hasp/hasp_<version>_<os>_<arch>/bin/hasp

Upgrade a packaged release

scripts/hasp-upgrade-release.sh --verify \
  dist/release/hasp_<new-version>_<os>_<arch>.tar.gz \
  "$HOME/.local/share/hasp/hasp_<old-version>_<os>_<arch>"

You can also use the CLI upgrade command when you want HASP to fetch and verify a published release:

hasp upgrade --version v1.0.1 --yes

Uninstall a packaged release

scripts/hasp-uninstall-release.sh "$HOME/.local/share/hasp/hasp_<version>_<os>_<arch>"

The default uninstall path removes the installed release tree only. Pass --remove-hooks-from <repo> or --purge-hasp-home <path> only when that cleanup is intentional.

Source build

Use source builds for development:

make build
bin/hasp version

Source builds are not the normal user install path.