Files
GitHop/wiki/Upgrading-and-Uninstalling.md
T
Hop de99aad4d4 Reconcile Gitea distribution with current alpha behavior and release tooling
Hop-State: A_06FN55REVAR7VQG4BWJBCD8
Hop-Proposal: R_06FN55QTEWKH16NSR59YJYG
Hop-Task: T_06FN3MBF98GWD4NA5PA1RWG
Hop-Attempt: AT_06FN55BQ80H2S8WHNDD24G0
2026-07-11 12:10:59 -07:00

1.6 KiB

Upgrading and uninstalling

Upgrade packaged installations

Rerun the installer. It replaces the binary and refreshes the embedded skill:

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

Pin a release when required:

curl -fsSL https://githop.xyz/hop/hop/raw/branch/main/scripts/install.sh | \
  HOP_VERSION=v0.1.0 sh

Windows:

irm https://githop.xyz/hop/hop/raw/branch/main/scripts/install.ps1 -OutFile install.ps1
.\install.ps1 -Version v0.1.0
Remove-Item install.ps1

After upgrading:

hop version
hop skill install --force
hop doctor

Restart Codex Desktop when the installed skill changed.

Upgrade Go installations

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

Project migrations

Hop opens and migrates older supported SQLite schemas automatically. Back up important repositories before alpha upgrades and read the release notes for any one-way schema change.

Uninstall the CLI and skill

Unix default:

rm -f "$HOME/.local/bin/hop"
rm -rf "${CODEX_HOME:-$HOME/.codex}/skills/hop"

Windows PowerShell:

Remove-Item -Force "$env:LOCALAPPDATA\Programs\Hop\hop.exe"
Remove-Item -Recurse -Force "$HOME\.codex\skills\hop"

Remove the Hop install directory from PATH if it is no longer used.

Uninstalling the program does not delete project-local .hop/ histories. That is intentional, so reinstalling restores access. Deleting a project's .hop/ directory permanently removes its prompt graph, evidence, workspaces, and accepted Hop history; make a backup and treat that as destructive data removal.