linux/zsh-autosuggestions
1
0
Fork 0
mirror of https://github.com/zsh-users/zsh-autosuggestions.git synced 2024-11-18 09:51:06 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
Fish-like autosuggestions for zsh
39 commits 14 branches 40 tags 1.1 MiB
Shell 63.1%
Ruby 35.6%
Makefile 0.8%
Dockerfile 0.5%
Find a file
Thiago de Arruda bd11c34e84 Merge pull request #16 from piecioshka/master 
Create automatic command for plugin setup
2014-03-14 08:03:20 -02: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 add a config for RIGHT arrow to accept the suggestion, like in fish 2014-02-23 22:54:31 +02: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

README.mkd

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.