hop

single-key marks for your terminal.

Install

cargo install hop-rs
./shell/install.sh

hop supports zsh, bash, and fish.

Themes

hop includes 7 built-in color schemes: tokyo-night, material-you, catppuccin, linear, nord, rose-pine, and gruvbox.

hop theme              # preview palettes
hop theme material-you # set global default
hop --theme linear     # one-off override

You can also press t in the picker to cycle themes on the fly (unless t is bound to a mark).

Usage

Give a key a target:

hop mark d ~/projects
hop mark b "cargo build --release"

Then run:

hop

Choose a mark with its key, or use ↑ / ↓ and Enter.

You can also mark the current directory:

hop mark d

List or remove marks:

hop list
hop unmark d

Local marks

Marks can be kept in a project's .hop.toml:

hop mark d ./docs --local

Local marks take precedence over the global configuration.

[marks.d]
target = "/home/user/projects/docs"
kind = "dir"

[marks.b]
target = "cargo build --release"
kind = "cmd"

Global marks are stored in:

~/.config/hop/global.toml

How it works

hop uses explicit key-to-target mappings.

There is no frecency or automatic reordering. If d points to a directory, it stays there until you change it.

Marks can point to:

• directories
• files
• shell commands

The shell integration uses the selected target to either cd into a directory, open a file with $EDITOR, or evaluate a command.

License

MIT