Downloads and installation

View as Markdown

handup ships as compiled binaries and packages from its public release host, github.com/gethandup/handup. Downloads are public; you never need the application source, Git, Rust, Make or an Android SDK.

A handup Personal license is $30 USD one-time, sold through Polar (merchant of record): one person on their own machines, perpetual use and all future released updates. The license key arrives by email after checkout. No hosted service, unlimited personal support or indefinite development is promised.

No public release has been published yet. The commands below work once the first release is out; until then the release page has no files.

Platforms

Platform	Package	Status
Linux x86-64 / ARM64	install script, AUR, .deb, .rpm, Alpine .apk, tar.gz	Primary platform. ARM64 builds are not runtime-tested.
Linux desktop app, x86-64	AppImage, .deb, .rpm	Pre-alpha; needs the CLI daemon installed too.
macOS Intel / Apple Silicon	Homebrew cask, tar.gz	Built but untested; not notarized.
Android	APK (sideload)	Pre-alpha companion app for the daemon on your computer.
iPhone / iPad	—	No native app. Use the daemon’s web inbox over Tailscale.
Windows	—	Not available. The Linux build in WSL is untested.

Linux

Any distribution (install script)

curl -fsSL https://github.com/gethandup/handup/releases/latest/download/install.sh | sh

The script detects your OS and CPU (x86-64 or ARM64), downloads the matching handup_<version>_<os>_<arch>.tar.gz, verifies it against the release checksums.txt (SHA-256) and installs handup to ~/.local/bin. It never uses sudo and refuses to install if the checksum is missing or wrong.

Variable	Default	Purpose
`HANDUP_INSTALL_DIR`	`~/.local/bin`	Install directory (must be writable).
`HANDUP_VERSION`	latest	Release tag to install, e.g. `v0.1.0`.

Arch Linux (AUR)

yay -S handup-bin

handup-bin repackages the released x86-64/ARM64 binary into /usr/bin/handup.

Debian and Ubuntu

Download handup_<version>_amd64.deb (or _arm64.deb) from the release, then:

sudo apt install ./handup_*.deb

Fedora and RHEL

Download handup-<version>-1.x86_64.rpm (or .aarch64.rpm), then:

sudo dnf install ./handup-*.rpm

Alpine

The Alpine package contains a musl build. It is not signed with an Alpine key, so verify its checksum first (below), then:

sudo apk add --allow-untrusted ./handup_*.apk

Desktop app

Download handup-desktop_<version>_amd64.AppImage (or the desktop .deb/.rpm bundle), then:

chmod +x ./handup-desktop_*.AppImage && ./handup-desktop_*.AppImage

The desktop app is an inbox for the handup daemon; install the CLI with one of the methods above as well. See desktop.

macOS (untested)

brew install --cask gethandup/tap/handup

The install script above also works on macOS. Builds exist for Intel and Apple Silicon but have not been tested, and the binary is not notarized: the cask removes the download quarantine flag for you.

Android

Download handup-android_<version>_arm64.apk on the phone, allow your browser to install unknown apps when Android asks, and open it. Pair it with handup pair on the computer. See mobile.

iPhone and iPad

There is no native iOS app. Enable Tailscale mode and pair; then open the pairing link in Safari and add it to the Home Screen:

handup config set remote.mode tailscale
handup pair

See remote access.

Verify a download

Every release publishes checksums.txt with SHA-256 sums for all files. Put it next to your download and check:

curl -fsSLO https://github.com/gethandup/handup/releases/latest/download/checksums.txt
sha256sum --ignore-missing -c checksums.txt          # Linux
shasum -a 256 --ignore-missing -c checksums.txt      # macOS

For an older release, replace latest/download with download/<tag>. The install script, AUR package and Homebrew cask verify checksums for you.

After installing

handup service install
handup doctor --json
handup integrate claude

See agent setup for other agents.

Updates

Every update is a new binary release; see the changelog.

Install script: re-run the same one-liner. It upgrades only when the release is newer, keeps the previous binary as handup.backup.<date> (newest three kept) and restores it if the new binary fails to start.
AUR: yay -Syu. Debian/Fedora/Alpine: install the newer package file the same way.
Homebrew: brew upgrade --cask handup.
Android: install the newer APK over the old one.

Uninstall

Install script:

handup uninstall

or, without a working binary, curl -fsSL https://github.com/gethandup/handup/releases/latest/download/uninstall.sh | sh -s -- --yes. Both remove the binary from ~/.local/bin (or HANDUP_INSTALL_DIR) plus installer backups. Configuration and data are kept.

Packages: yay -R handup-bin, sudo apt remove handup, sudo dnf remove handup, sudo apk del handup, brew uninstall --cask handup. Run handup service uninstall first if you installed the user service.

Source and documentation

The application source stays private. Buying a personal license does not grant repository access or application-source modification rights. Public usage documentation, machine contracts and agent instructions are distributed separately from the application repository.

Some integrations and web assets necessarily include readable scripts; that is not publication of the complete application source. Third-party components retain their licenses, and distribution must satisfy their notice and any applicable source-offer requirements.