https://github.com/joshskidmore/zsh-fzf-history-search
A simple zsh plugin that replaces Ctrl+R with an fzf-driven select which includes date/times.
https://github.com/joshskidmore/zsh-fzf-history-search
Last synced: 8 months ago
JSON representation
A simple zsh plugin that replaces Ctrl+R with an fzf-driven select which includes date/times.
- Host: GitHub
- URL: https://github.com/joshskidmore/zsh-fzf-history-search
- Owner: joshskidmore
- License: mit
- Created: 2020-08-19T10:08:30.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-05-29T03:47:13.000Z (over 1 year ago)
- Last Synced: 2025-04-06T09:09:41.026Z (8 months ago)
- Language: Shell
- Homepage:
- Size: 25.4 KB
- Stars: 371
- Watchers: 5
- Forks: 25
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-zsh-plugins - fzf-history-search - Replaces `Ctrl+R` with an [fzf](https://github.com/junegunn/fzf)-driven history search that includes date/times. (Plugins / ZSH on Windows)
- fucking-awesome-zsh-plugins - fzf-history-search - Replaces `Ctrl+R` with an <b><code> 75058⭐</code></b> <b><code> 2613🍴</code></b> [fzf](https://github.com/junegunn/fzf))-driven history search that includes date/times. (Plugins / ZSH on Windows)
README
# 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
* [fzf](https://github.com/junegunn/fzf)
## Installation
### zinit
Add this to `~/.zshrc`:
```sh
# 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:
``` sh
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)
```
### [zgenom](https://github.com/jandamm/zgenom)
Add `joshskidmore/zsh-fzf-history-search` to your `.zshrc` file in the same function you're doing your other `zgenom load` calls in.
Zgenom will automatically clone the plugin repositories for you when you do a `zgenom save`.
## Configuration Variables
| Variable | Default | Description |
| ----------------------------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `ZSH_FZF_HISTORY_SEARCH_BIND` | `'^r'` | Keybind to trigger fzf reverse search |
| `ZSH_FZF_HISTORY_SEARCH_FZF_ARGS` | `'+s +m -x -e --preview-window=hidden'` | Arguments for `fzf` (might be updated, not recommended to override) |
| `ZSH_FZF_HISTORY_SEARCH_FZF_EXTRA_ARGS` | `''` | Extra arguments for `fzf` |
| `ZSH_FZF_HISTORY_SEARCH_FZF_QUERY_PREFIX` | `''` | Query prefix for `fzf` when $BUFFER is not empty. Set it to '^' to query history lines begin with $BUFFER |
| `ZSH_FZF_HISTORY_SEARCH_END_OF_LINE` | `''` | Put the cursor on at the end of the line after completion, `empty=false` |
| `ZSH_FZF_HISTORY_SEARCH_EVENT_NUMBERS` | `1` | Include event numbers in search. Set to 0 to remove event numbers from the search. |
| `ZSH_FZF_HISTORY_SEARCH_DATES_IN_SEARCH` | `1` | Include ISO8601 timestamps in search. Set to 0 to remove them from the search. |
| `ZSH_FZF_HISTORY_SEARCH_REMOVE_DUPLICATES`| `''` | Remove duplicate entries from search. Only makes sense with `EVENT_NUMBERS` and `DATE_INSEARCH` 0 (false).|
## TODO
* use fzf's keybindings for additional functionality (remove specific history item, clear history, etc) while keeping plugin's simplicity in mind ([issue](https://github.com/joshskidmore/zsh-fzf-history-search/issues/10))
* better documentation ([issue](https://github.com/joshskidmore/zsh-fzf-history-search/issues/11))