2013-10-27 00:05:17 +08:00
|
|
|
# zsh-autosuggestions
|
|
|
|
|
|
2014-11-05 18:51:26 +08:00
|
|
|
(Due to lack of time, I'm currently unable to maintain this project. I has a lot of bugs, so use at your own risk!)
|
|
|
|
|
|
2013-10-30 03:08:56 +08:00
|
|
|
> [Fish](http://fishshell.com/)-like fast/unobtrusive autosuggestions for zsh.
|
2013-10-27 00:05:17 +08:00
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
2013-11-08 07:17:10 +08:00
|
|
|
```sh
|
2014-01-26 06:47:40 +08:00
|
|
|
$ git clone git://github.com/tarruda/zsh-autosuggestions ~/.zsh-autosuggestions
|
2013-11-08 07:17:10 +08:00
|
|
|
|
2014-01-26 06:47:40 +08:00
|
|
|
$ cat >> ~/.zshrc << "EOF"
|
|
|
|
|
|
2014-01-26 06:49:29 +08:00
|
|
|
# Setup zsh-autosuggestions
|
2013-10-27 00:05:17 +08:00
|
|
|
source ~/.zsh-autosuggestions/autosuggestions.zsh
|
2013-11-08 07:17:10 +08:00
|
|
|
|
2013-10-27 00:05:17 +08:00
|
|
|
# Enable autosuggestions automatically
|
|
|
|
|
zle-line-init() {
|
2013-10-30 01:32:51 +08:00
|
|
|
zle autosuggest-start
|
2013-10-27 00:05:17 +08:00
|
|
|
}
|
|
|
|
|
zle -N zle-line-init
|
2013-11-08 07:17:10 +08:00
|
|
|
|
2013-11-08 19:20:57 +08:00
|
|
|
# use ctrl+t to toggle autosuggestions(hopefully this wont be needed as
|
2013-11-08 19:24:02 +08:00
|
|
|
# zsh-autosuggestions is designed to be unobtrusive)
|
2013-10-30 01:32:51 +08:00
|
|
|
bindkey '^T' autosuggest-toggle
|
2014-01-26 06:44:37 +08:00
|
|
|
EOF
|
2014-01-26 06:47:40 +08:00
|
|
|
|
2013-11-08 19:20:57 +08:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
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:
|
2013-11-08 07:17:10 +08:00
|
|
|
|
2013-11-08 19:20:57 +08:00
|
|
|
```sh
|
|
|
|
|
# Accept suggestions without leaving insert mode
|
|
|
|
|
bindkey '^f' vi-forward-word
|
2013-12-04 03:25:52 +08:00
|
|
|
# or
|
2013-11-08 19:20:57 +08:00
|
|
|
bindkey '^f' vi-forward-blank-word
|
2013-10-27 00:05:17 +08:00
|
|
|
```
|
2013-11-08 19:20:57 +08:00
|
|
|
|
|
|
|
|
Emacs-mode users can simply use alt+f which is bound to forward-word
|
|
|
|
|
|
|
|
|
|
The [zsh-history-substring-search](https://github.com/zsh-users/zsh-history-substring-search)
|
|
|
|
|
plugin is also recommended.
|
2013-12-04 03:45:56 +08:00
|
|
|
|
|
|
|
|
## 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`.
|
