Go to file
Javi Merino 754d074027 Add an option to remove event numbers from search
Event numbers don't add information to the search: if you knew the
event number you wouldn't be searching for the command.  Add an option
to remove them from the search to declutter it.  Default it to true to
preserve the current behaviour.
2022-05-09 07:21:59 +01:00
2020-08-21 23:01:21 -04:00

zsh/fzf History Search

zsh-fzf-history-search plugin screenshot

A simple zsh plugin to replace Ctrl-r with an fzf-driven, searchable list of history.

Pull requests always appreciated!

Requirements

Installation

zinit

Add this to ~/.zshrc:

# zsh-fzf-history-search
zinit ice lucid wait'0'
zinit light joshskidmore/zsh-fzf-history-search

oh-my-zsh

Clone the repository inside your oh-my-zsh repo:

git clone https://github.com/joshskidmore/zsh-fzf-history-search ${ZSH_CUSTOM:=~/.oh-my-zsh/custom}/plugins/zsh-fzf-history-search

Enable it in your .zshrc by adding it to your plugin list:

plugins=(… zsh-fzf-history-search)

Configuration Variables

Variable Description
ZSH_FZF_HISTORY_SEARCH_BIND Keybind to trigger fzf reverse search (default: '^r')
ZSH_FZF_HISTORY_SEARCH_FZF_ARGS Arguments for fzf (might be updated, not recommended to override) (default: '+s +m -x -e')
ZSH_FZF_HISTORY_SEARCH_FZF_EXTRA_ARGS Extra arguments for fzf (default: '')
ZSH_FZF_HISTORY_SEARCH_END_OF_LINE Put the cursor on at the end of the line after completion, empty=false (default: '')
ZSH_FZF_HISTORY_SEARCH_EVENT_NUMBERS Include event numbers in search. Set to 0 to remove event numbers from the search. (default: 1)

TODO

  • use fzf's keybindings for additional functionality (remove specific history item, clear history, etc) while keeping plugin's simplicity in mind (issue)
  • better documentation (issue)
Languages
Shell 100%