Files

T

Hop aad987e762

CI / test (push) Waiting to run

CI / powershell-installer (push) Waiting to run

Reconcile canonical GnosysLabs/Hop publishing paths with accepted release implementation

Hop-State: A_06FN5C39XCC4JXJEAKVD5S0
Hop-Proposal: R_06FN5C2KP6Z8BKCP0KK1QZ0
Hop-Task: T_06FN3MBF98GWD4NA5PA1RWG
Hop-Attempt: AT_06FN5B04YJGZ2NFP2TJWM1R

2026-07-11 12:38:41 -07:00

2.5 KiB

Raw Blame History

Installation

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

macOS and Linux

curl -fsSL https://githop.xyz/GnosysLabs/Hop/raw/branch/main/scripts/install.sh | sh

The installer:

detects macOS/Linux and amd64/arm64;
downloads the matching archive from the latest Gitea 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 for Codex.

Review before execution:

curl -fsSLO https://githop.xyz/GnosysLabs/Hop/raw/branch/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 `v0.1.0`
`HOP_INSTALL_DIR`	`~/.local/bin`	Binary destination
`HOP_INSTALL_SKILL`	`1`	Set to `0` to skip Codex skill installation
`HOP_MODIFY_PATH`	`1`	Set to `0` to leave shell profiles unchanged
`HOP_GITEA_URL`	`https://githop.xyz`	Gitea instance base URL
`HOP_REPOSITORY`	`GnosysLabs/Hop`	Alternate Gitea owner/repository

Example:

HOP_VERSION=v0.1.0 HOP_INSTALL_DIR="$HOME/bin" sh install.sh

Windows

In PowerShell as your normal user:

irm https://githop.xyz/GnosysLabs/Hop/raw/branch/main/scripts/install.ps1 | iex

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

.\install.ps1 -Version v0.1.0

Use -SkipSkill only when another agent runtime will receive the skill. Use -SkipPath when another tool manages your PATH.

Go install

With Go 1.26 or newer:

go install githop.xyz/GnosysLabs/Hop/cmd/hop@latest
hop skill install --force

Put $(go env GOPATH)/bin on PATH if hop is not found.

Build from source

git clone https://githop.xyz/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.

Verify

hop version
hop help
git --version

If Codex Desktop was open during installation, restart it. See Getting started next.

2.5 KiB Raw Blame History