zsh-peco-history

Search shell history with peco when pressing ctrl+r.

Based on zsh-history-search snippet from percol.

Usage

1. Press ctrl+r while in a zsh shell and it should load up peco with your shell's history.
2. Start typing to filter history down.
3. Press enter/return to pick a command from history.

Requirements

• peco
• psh
• tac, or tail with support for -r option.

Installation

Manual

1. Clone this repo to your machine. This guide uses ~/.zsh/zsh-peco-history:

   git clone https://github.com/jimeh/zsh-peco-history.git ~/.zsh/zsh-peco-history
   

2. Add the following to your .zshrc:

   source ~/.zsh/zsh-peco-history/zsh-peco-history.zsh
   

3. Start a new terminal session.

Zplug

1. Add a zplug definition for zsh-peco-history to your .zshrc:

   zplug "jimeh/zsh-peco-history"
   

2. Start a new terminal session.

Antigen

1. Add a antigen bundle definition for zsh-peco-history to your .zshrc:

   antigen bundle jimeh/zsh-peco-history
   

2. Start a new terminal session.

Oh My Zsh

1. Clone this repository into $ZSH_CUSTOM/plugins (by default ~/.oh-my-zsh/custom/plugins)

   git clone https://github.com/jimeh/zsh-peco-history.git $ZSH_CUSTOM/plugins/zsh-peco-history
   

2. Add the plugin to the list of plugins for Oh My Zsh to load:

   plugins=(zsh-peco-history)
   

3. Start a new terminal session.

Recommended Peco Config

You don't have to use this config, it's simply what I personally use. So here's what my ~/.peco/config.json file looks like:

{
  "Keymap": {
    "M-v": "peco.ScrollPageUp",
    "C-v": "peco.ScrollPageDown",
    "C-g": "peco.Cancel",
    "M-Space": "peco.ToggleRangeMode",
    "M-c": "peco.CancelRangeMode"
  },
  "Style": {
    "Basic": ["on_default", "default"],
    "Matched": ["cyan"],
    "Query": ["default"],
    "SavedSelection": ["on_blue", "white"],
    "Selected": ["on_magenta", "default"]
  }
}

License

CC0 1.0 Universal