Importing

Seed hop with your existing shell history or data from other tools on first install.

zsh history

hop import zsh ~/.zsh_history

Imports directories from your zsh history file. The default location is ~/.zsh_history.

fasd

hop import fasd ~/.fasd

fasd stores its data at ~/.fasd by default.

autojump

hop import autojump ~/.local/share/autojump/autojump.txt

autojump's data file is at ~/.local/share/autojump/autojump.txt (or ~/.autojump.txt on some systems).

zoxide

hop import zoxide ~/.local/share/zoxide/data.zzd

zoxide's database is at ~/.local/share/zoxide/data.zzd.

Dry run

To preview what would be imported without writing to the database:

hop import zsh ~/.zsh_history --dry-run
hop import fasd ~/.fasd --dry-run

How it works

Import reads the source file, extracts directory paths, and inserts them into hop's SQLite database with a neutral visit count so they participate in fuzzy matching alongside your real visit history. Directories that no longer exist on disk are skipped.