Installation

Packaged binaries are the recommended installation. They need Git 2.40 or newer; they do not need a local Go toolchain.

The platform installers are Hop's no-Node bootstrap and recovery path. Once installed, hop update handles normal standalone upgrades and refreshes the bundled agent skill automatically.

macOS and Linux

curl -fsSL https://raw.githubusercontent.com/GnosysLabs/Hop/main/scripts/install.sh | sh

The installer:

detects macOS/Linux and amd64/arm64;
downloads the matching archive from the latest GitHub Release;
downloads checksums.txt and verifies SHA-256 before extraction;
installs the CLI to ~/.local/bin/hop;
adds ~/.local/bin to .zprofile or .profile when necessary; and
runs hop skill install --force to install the bundled agent integration.

The no-path skill command writes the same Hop-managed skill files to ~/.agents/skills/hop, ${CODEX_HOME:-~/.codex}/skills/hop, and ~/.claude/skills/hop. The client-specific paths support Codex Desktop and Claude Code; compatible clients can use the shared .agents path.

Review before execution:

curl -fsSLO https://raw.githubusercontent.com/GnosysLabs/Hop/main/scripts/install.sh
less install.sh
sh install.sh

Installer options are environment variables:

Variable	Default	Purpose
`HOP_VERSION`	`latest`	Release tag such as `v1.1.4`
`HOP_INSTALL_DIR`	`~/.local/bin`	Binary destination
`HOP_INSTALL_SKILL`	`1`	Set to `0` for a CLI-only or custom integration
`HOP_MODIFY_PATH`	`1`	Set to `0` to leave shell profiles unchanged
`HOP_RELEASE_API_URL`	`https://api.github.com`	Release API base URL
`HOP_RELEASE_URL`	`https://github.com`	Release download base URL
`HOP_REPOSITORY`	`GnosysLabs/Hop`	Alternate release owner/repository

Example:

HOP_VERSION=v1.1.4 HOP_INSTALL_DIR="$HOME/bin" sh install.sh

Windows

In PowerShell as your normal user:

irm https://raw.githubusercontent.com/GnosysLabs/Hop/main/scripts/install.ps1 | iex

The script verifies the Windows archive, installs to %LOCALAPPDATA%\Programs\Hop, updates the user PATH, and installs the shared, Codex, and Claude Code skill bundles. To pin a version after downloading the script:

.\install.ps1 -Version v1.1.4

Use -SkipSkill for a CLI-only or separately managed integration. Use -SkipPath when another tool manages your PATH.

Go install

With Go 1.26 or newer:

go install github.com/GnosysLabs/Hop/cmd/hop@latest
hop skill install --force

Put $(go env GOPATH)/bin on PATH if hop is not found. The second command installs all default skill bundles; omit it for a CLI-only installation.

Build from source

git clone https://github.com/GnosysLabs/Hop.git
cd hop
go test ./...
go build -trimpath -o hop ./cmd/hop
mkdir -p "$HOME/.local/bin"
install -m 755 hop "$HOME/.local/bin/hop"
"$HOME/.local/bin/hop" skill install --force

Source builds are intended for contributors and as a pre-release fallback.

To install only one compatible runtime target, pass its parent skills directory:

hop skill install --path /path/to/agent/skills --force

Verify

hop version
hop help
git --version

Restart any agent client that was open while its skill bundle changed. See Getting started next.