mirror of https://github.com/joshskidmore/zsh-fzf-history-search.git synced 2026-09-10 07:06:21 -04:00

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

Go to file

Josh Skidmore 1c41f581aa Merge pull request #16 from JaviMerino/no_event_number Don't include event numbers in search		2022-05-10 15:42:38 -04:00
LICENSE	add license	2020-08-21 23:01:21 -04:00
README.md	Add an option to remove event numbers from search	2022-05-09 07:21:59 +01:00
zsh-fzf-history-search.plugin.zsh	feat: add *.plugin.zsh (backwards compatible)	2021-08-31 02:09:15 +02:00
zsh-fzf-history-search.zsh	Add an option to remove event numbers from search	2022-05-09 07:21:59 +01:00

zsh/fzf History Search

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

Pull requests always appreciated!

Requirements

Add this to ~/.zshrc:

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

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)

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`)

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)