Installation

One-liner (recommended)

curl -fsSL https://codeberg.org/dioxus/hop/raw/branch/main/install.sh | bash

Downloads the latest binary for your platform, places it in ~/.local/bin, and prints instructions if you need to add that to your PATH.

From source

Requires Rust 1.75+.

git clone https://codeberg.org/dioxus/hop
cd hop
cargo install --path .

Verify

hop doctor

Self-update

hop update # check and install latest release
hop update --dry-run # just check, don't install

Uninstall

# Remove the binary
rm ~/.local/bin/hop
# Remove shell integration (edit your ~/.bashrc / ~/.zshrc / etc.)
# Remove the line: eval "$(hop init bash)" (or your shell)
# Remove data
rm -rf ~/.local/share/hop # Linux
rm -rf ~/Library/Application\ Support/hop # macOS

Upgrading from fuzzy-cd

hop automatically imports your old database from ~/Library/Application Support/fuzzy-cd/ on first run. Your history and bookmarks are preserved.

Update your shell config from fuzzy-cd init ... to hop init <shell> — see Shell Setup.