mirror of
https://github.com/zsh-users/zsh-autosuggestions.git
synced 2024-11-18 09:51:06 +01:00
Fish-like autosuggestions for zsh
lib | ||
.gitignore | ||
autosuggestions.zsh | ||
LICENSE-MIT | ||
README.mkd | ||
zsh-autosuggestions.plugin.zsh |
zsh-autosuggestions
Fish-like fast/unobtrusive autosuggestions for zsh. Shelr demo.
Installation
git clone git://github.com/tarruda/zsh-autosuggestions ~/.zsh-autosuggestions
cat >> ~/.zshrc << "EOF"
source ~/.zsh-autosuggestions/autosuggestions.zsh
# Enable autosuggestions automatically
zle-line-init() {
zle autosuggest-start
}
zle -N zle-line-init
# use ctrl+t to toggle autosuggestions(hopefully this wont be needed as
# zsh-autosuggestions is designed to be unobtrusive)
bindkey '^T' autosuggest-toggle
Any widget that moves the cursor to the right(forward-word, forward-char...) will accept parts of the suggested text. For example, vi-mode users can do this:
# Accept suggestions without leaving insert mode
bindkey '^f' vi-forward-word
# or
bindkey '^f' vi-forward-blank-word
Emacs-mode users can simply use alt+f which is bound to forward-word
The zsh-history-substring-search plugin is also recommended.
With oh-my-zsh
-
Download the script or clone this repository in oh-my-zsh plugins directory:
cd ~/.oh-my-zsh/custom/plugins git clone git://github.com/tarruda/zsh-autosuggestions.git
-
Activate the plugin in
~/.zshrc
(in last position):plugins=( [plugins...] zsh-autosuggestions)
-
Source
~/.zshrc
to take changes into account:source ~/.zshrc
Configuration
You may override default global config variables after plugin load.
AUTOSUGGESTION_HIGHLIGHT_COLOR
: suggestion highlight color, default is'fg=8'
.AUTOSUGGESTION_HIGHLIGHT_CURSOR
: highlight word after cursor or not. Must be integer value1
or0
, default is1
.