prezto/modules/history-substring-search

History Substring Search

Integrates zsh-history-substring-search into Prezto, which implements the Fish shell's history search feature, where the user can type in any part of a previously entered command and press up and down to cycle through matching commands.

If this module is used in conjunction with the syntax-highlighting module, this module must be loaded after the syntax-highlighting module.

Additionally, if this module is used in conjunction with the autosuggestions module, this module must be loaded before the autosuggestions module.

To elaborate, the relative order of loading the modules would be syntax-highlighting, history-substring-search and autosuggestions.

Contributors

New features and bug fixes should be submitted to the zsh-history-substring-search project according to its rules and regulations. This module will be synchronized against it.

Settings

Case Sensitivity

To enable case-sensitivity for this module only, add the following line to ${ZDOTDIR:-$HOME}/.zpreztorc:

zstyle ':prezto:module:history-substring-search' case-sensitive 'yes'

Highlighting

If colors are enabled, history-substring-search will automatically highlight positive results.

To disable highlighting for this module only, add the following line to ${ZDOTDIR:-$HOME}/.zpreztorc:

zstyle ':prezto:module:history-substring-search' color 'no'

To set the query found color, add the following line to ${ZDOTDIR:-$HOME}/.zpreztorc:

zstyle ':prezto:module:history-substring-search:color' found ''

To set the query not found color, add the following line to ${ZDOTDIR:-$HOME}/.zpreztorc:

zstyle ':prezto:module:history-substring-search:color' not-found ''

To set the search globbing flags, add the following line to ${ZDOTDIR:-$HOME}/.zpreztorc:

zstyle ':prezto:module:history-substring-search' globbing-flags ''

To set the search matched against the start of each history entry, add the following line to
_`${ZDOTDIR:-$HOME}/.zpreztorc`_:

```sh
zstyle ':prezto:module:history-substring-search' prefixed 'yes'

Fuzzy search

To enable fuzzy search add the following line to ${ZDOTDIR:-$HOME}/.zpreztorc_:

zstyle ':prezto:module:history-substring-search' fuzzy 'yes'

Unique results

To retrieve only unique results (remove duplicates) add the following line to ${ZDOTDIR:-$HOME}/.zpreztorc_:

zstyle ':prezto:module:history-substring-search' ensure-unique 'yes'

Authors

The authors of this module should be contacted via the issue tracker.

• Suraj N. Kurapati
• Sorin Ionescu