dioxus/hop

Code Issues Pull requests Releases 3 Wiki Activity Actions

A fuzzy cd alternative written in Rust

61 commits 2 branches 13 tags 721 KiB

Rust 98.2%
Shell 1.8%

Find a file

Dorian d5f00fba3a chore: bump version to 1.3.3		2026年05月06日 17:39:38 +02:00
.forgejo/workflows	ci: restore .forgejo/workflows/release.yml for Codeberg Actions release	2026年05月06日 15:16:04 +02:00
src	feat(cli): styled output — colored paths, success/error indicators, dividers	2026年05月06日 17:27:46 +02:00
tests	feat: P2 — Nushell/Elvish shell integrations + hop book edit	2026年05月05日 14:59:09 +02:00
.gitignore	ignore SPEC.md	2026年05月06日 09:10:07 +02:00
Cargo.lock	feat(cli): styled output — colored paths, success/error indicators, dividers	2026年05月06日 17:27:46 +02:00
Cargo.toml	chore: bump version to 1.3.3	2026年05月06日 17:39:38 +02:00
install.sh	fix(install): resolve asset download URL via Codeberg API	2026年05月06日 17:33:56 +02:00
LICENSE	v0.6.0: completions, init --verify/--shell, release workflow, rust-version, LICENSE	2026年04月20日 11:41:21 +02:00
README.md	docs: lean README as wiki landing page	2026年05月06日 09:27:46 +02:00

README.md

hop

Fuzzy directory jumper for your terminal.

Type a fragment, hit enter, go anywhere. hop learns your habits and gets smarter over time.

~ $ h dl
~/Downloads
~/Downloads $ h proj
~/code/work/project

No more cd ../../../long/path. No more memorizing aliases.

Install

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

Then add shell integration:

Shell	Add this to your config file
Bash	`eval "$(hop init bash)"`
Zsh	`eval "$(hop init zsh)"`
Fish	`hop init fish \| source`
Nushell	`hop init nushell \| save ~/.local/bin/hop.nu` then `use ~/.local/bin/hop.nu` in config.nu
Elvish	`hop init elvish > ~/.config/hop/hop.elv` then `use ~/.config/hop/hop.elv` in rc.elv

Restart your shell. That's it — h is now a function that jumps to directories.

Quick usage

h proj → jump to best match from history
hop /tmp → literal path works too
hop → open the interactive picker
hop book w ~/code/work → bookmark a directory
h w → jump to bookmark

Documentation

All the details are in the wiki:

Installation — one-liner, from source, self-update, uninstall
Shell Setup — bash, zsh, fish, nushell, elvish
Usage — all commands with examples
Configuration — config.toml reference
Importing — migrate from zsh/fasd/autojump/zoxide
Troubleshooting — common issues and fixes
Changelog — release notes

Verify

hop doctor

Data

macOS: ~/Library/Application Support/hop/hop.db
Linux: ~/.local/share/hop/hop.db

License

MIT