Configuration

Create ~/.config/hop/config.toml. The file is created automatically on first run with default values.

Options

# Directories scanned during `hop reindex`
# Default: []
index_roots = ["~/code", "~/work"]
# Skip these during reindex (not during normal h matching)
# Default: ["node_modules", "target", ".venv", ".git", "__pycache__", ".pytest_cache"]
skip_dirs = ["node_modules", "target", ".venv", ".git"]
# How deep to walk subdirectories during reindex
# Default: 6
max_depth = 6
# Reject fuzzy matches below this score
# Higher = stricter matching (fewer false positives)
# Lower = looser matching (more results, more noise)
# Default: 20
min_score = 20
# Prune stale entries on startup automatically
# 0 = disabled (default)
# N = prune entries older than N days
auto_prune_on_startup = 0

After changing config

If you changed index_roots, skip_dirs, or max_depth, rebuild the index:

hop reindex

Database location

Back up by copying the .db file.