Fish-like autosuggestions for zsh

autocomplete autosuggest fish shell zsh zsh-autosuggestions

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

Xtreak c740515df4 Added clarification to use bash Some linux distros have sh symlinked to dash. So I have added a clarification to use bash for the distros.		11 years ago
.gitignore	First commit	12 years ago
LICENSE-MIT	First commit	12 years ago
README.mkd	Added clarification to use bash	11 years ago
autosuggestions.plugin.zsh	add autosuggestions.plugin.zsh to get this repo working with antigen	12 years ago
autosuggestions.zsh	Merge pull request #31 from maksimr/patch-1	11 years ago
completion-client.zsh	Refactored, only use completion server on	12 years ago
completion-server-init.zsh	Add magic prefix to distinguish completion lines	12 years ago
completion-server.zsh	Direct less frequent log messages to stderr for	12 years ago
install	Fixed: installation on OS X fails	11 years ago

README.mkd

zsh-autosuggestions

Fish-like fast/unobtrusive autosuggestions for zsh.

Installation

    $ git clone git://github.com/tarruda/zsh-autosuggestions ~/.zsh-autosuggestions
    $ sh ~/.zsh-autosuggestions/install

On some linux distributions like ubuntu and debian sh is symlinked to /bin/dash and causes an installation error since the installation script needs some bash features. If sh is symlinked to dash, please run it with the bash :

bash ~/.zsh-autosuggestions/install

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.

Known Issues

COMPLETION_WAITING_DOTS: setting this to true is known to cause problems when attempting to autocomplete with TAB