Fish-like autosuggestions for zsh
  • Shell 63.1%
  • Ruby 35.6%
  • Makefile 0.8%
  • Dockerfile 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Thiago de Arruda 85739dbe76 Disable autosuggestion server startup.
The server is not working even in zsh5. Disable it until fixed.
2014-09-22 10:08:24 -03:00
.gitignore First commit 2013-10-26 13:05:17 -03:00
autosuggestions.plugin.zsh add autosuggestions.plugin.zsh to get this repo working with antigen 2014-02-25 22:45:29 +02:00
autosuggestions.zsh Disable autosuggestion server startup. 2014-09-22 10:08:24 -03:00
completion-client.zsh Refactored, only use completion server on 2013-11-07 18:42:17 -03:00
completion-server-init.zsh Add magic prefix to distinguish completion lines 2013-10-29 08:26:59 -03:00
completion-server.zsh Direct less frequent log messages to stderr for 2013-10-30 08:36:53 -03:00
LICENSE-MIT First commit 2013-10-26 13:05:17 -03:00
README.mkd start label with big letter 2014-01-25 23:49:29 +01:00

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"

# Setup zsh-autosuggestions
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
EOF

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.

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 value 1 or 0, default is 1.