fzf shell integration is never wired on a fresh machine
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 74/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- shell, zsh
- Domain
- cli, developer-experience
Research direction
Read .zshrc and Brewfile.cli, then check how install/bootstrap.zsh sets up shell configuration. Choose how to make fzf keybindings and completion available on a fresh machine, accounting for the installed fzf version. Done when a fresh bootstrap provides both without relying on a missing ~/.fzf.zsh.
Written by the indexing model from the issue text.
Description
`.zshrc` sources `~/.fzf.zsh` when it exists:
```zsh
[ -f ~/.fzf.zsh ] && source ~/.fzf.zsh
```
Nothing in the repo creates that file. The Homebrew `fzf` formula in `Brewfile.cli` installs the binary only, and its caveat points at the upstream setup (`$(brew --prefix)/opt/fzf/install`, or `source <(fzf --zsh)` on fzf 0.48+). On a machine bootstrapped from `install/bootstrap.zsh` the keybindings and completion are therefore absent.
Found on the first full tart VM run of the bootstrap, 2026-10-21.
Options
- Replace the `~/.fzf.zsh` line in `.zshrc` with `command -v fzf >/dev/null && source <(fzf --zsh)`, which needs no generated file and follows the installed version.
- Or have an installer run `$(brew --prefix)/opt/fzf/install --key-bindings --completion --no-update-rc` and keep the sourced file.
The first is the smaller change and has no state to drift.
- Dominant language
- Shell
- Stars
- 1
- Forks
- 0
- Avg merge
- 14h 36m
- Merged PRs (30d)
- 3
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- No contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from indexzero/dotfiles
-
Difficulty 4/5 3-5 days Newbie friendliness 56/100
-
Difficulty 4/5 3-5 days Newbie friendliness 42/100
-
Difficulty 4/5 3-5 days Newbie friendliness 39/100
-
Difficulty 1/5 Under an hour Newbie friendliness 48/100
-
Difficulty 5/5 Over a week Newbie friendliness 8/100
All issues in indexzero/dotfiles
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
MISP/misp-docker#478 ·
Maintainers usually reply within 1 day
-
roadmap-100
Difficulty 2/5 1-3 hours Newbie friendliness 80/100
Maintainers usually reply within 1 day
-
priority: medium status: needs-decision work-class: scoped
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
melodic-software/claude-code-plugins#9339 · 2 comments ·
Maintainers usually reply within 1 day
-
数据界面的横向滚动条缺失Open
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
zilliztech/attu#1037 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
community-scripts/ProxmoxVE#18073 · 1 comment ·
Maintainers usually reply within 1 day