ohmyzsh/plugins/alias-finder
Jacob Tomaw 1ba0af650a Use safer append to hook function arrays (#8406)
Use add-zsh-hook to add functions to hooks. That way they won't be added again
when doing `source ~/.zshrc` multiple times.

Co-authored-by: Marc Cornellà <marc.cornella@live.com>
2019-11-19 18:47:12 +01:00
..
README.md
alias-finder.plugin.zsh Use safer append to hook function arrays (#8406) 2019-11-19 18:47:12 +01:00

README.md

alias-finder plugin

This plugin searches the defined aliases and outputs any that match the command inputted. This makes learning new aliases easier.

To use it, add alias-finder to the plugins array of your zshrc file:

plugins=(... alias-finder)

Usage

To see if there is an alias defined for the command, pass it as an argument to alias-finder. This can also run automatically before each command you input - add ZSH_ALIAS_FINDER_AUTOMATIC=true to your zshrc if you want this.

Options

  • Use --longer or -l to allow the aliases to be longer than the input (match aliases if they contain the input).
  • Use --exact or -e to avoid matching aliases that are shorter than the input.

Examples

$ alias-finder "git pull"
gl='git pull'
g=git
$ alias-finder "web_search google oh my zsh"
google='web_search google'
$ alias-finder "git commit -v"
gc="git commit -v"
g=git
$ alias-finder -e "git commit -v"
gc='git commit -v'
$ alias-finder -l "git commit -v"
gc='git commit -v'
'gc!'='git commit -v --amend'
gca='git commit -v -a'
'gca!'='git commit -v -a --amend'
'gcan!'='git commit -v -a --no-edit --amend'
'gcans!'='git commit -v -a -s --no-edit --amend'
'gcn!'='git commit -v --no-edit --amend'