Files
Hop/wiki/Upgrading-and-Uninstalling.md
Hop 68d8bf2f7d Install portable agent-neutral Hop skill and documentation
Hop-State: A_06FN69X2VW0BAXG4A4DT6V0
Hop-Proposal: R_06FN69VET1STZNKPWK913K8
Hop-Task: T_06FN637799RW5Q7WH9H6PJR
Hop-Attempt: AT_06FN63779BJRBK1VFQ94GRR
2026-07-11 14:48:54 -07:00

76 lines
1.9 KiB
Markdown

# Upgrading and uninstalling
## Upgrade packaged installations
Rerun the installer. It replaces the binary and refreshes both default skill
bundles:
```bash
curl -fsSL https://githop.xyz/GnosysLabs/Hop/raw/branch/main/scripts/install.sh | sh
```
Pin a release when required:
```bash
curl -fsSL https://githop.xyz/GnosysLabs/Hop/raw/branch/main/scripts/install.sh | \
HOP_VERSION=v0.1.0 sh
```
Windows:
```powershell
irm https://githop.xyz/GnosysLabs/Hop/raw/branch/main/scripts/install.ps1 -OutFile install.ps1
.\install.ps1 -Version v0.1.0
Remove-Item install.ps1
```
After upgrading:
```bash
hop version
hop skill install --force
hop doctor
```
Restart any agent client whose installed skill changed.
## Upgrade Go installations
```bash
go install githop.xyz/GnosysLabs/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 bundles
Unix default:
```bash
rm -f "$HOME/.local/bin/hop"
rm -rf "$HOME/.agents/skills/hop"
rm -rf "${CODEX_HOME:-$HOME/.codex}/skills/hop"
```
Windows PowerShell:
```powershell
Remove-Item -Force "$env:LOCALAPPDATA\Programs\Hop\hop.exe"
Remove-Item -Recurse -Force "$HOME\.agents\skills\hop"
Remove-Item -Recurse -Force "$HOME\.codex\skills\hop"
```
If `CODEX_HOME` points somewhere else, remove its `skills\hop` directory instead
of `$HOME\.codex\skills\hop`. Remove any explicit `--path` target manually.
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.