zsh-autosuggestions/README.mkd

35 lines
1.1 KiB
Markdown
Raw Normal View History

2013-10-26 13:05:17 -03:00
# zsh-autosuggestions
2014-11-05 07:51:26 -03: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-29 16:08:56 -03:00
> [Fish](http://fishshell.com/)-like fast/unobtrusive autosuggestions for zsh.
2013-10-26 13:05:17 -03:00
## Installation
2014-11-21 13:54:47 -08:00
```
2014-11-21 13:59:25 -08:00
$ git clone git://github.com/wgallios/zsh-autosuggestions ~/.zsh-autosuggestions
2014-11-21 13:54:47 -08:00
sh .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:
2013-11-07 20:17:10 -03:00
```sh
# Accept suggestions without leaving insert mode
bindkey '^f' vi-forward-word
2013-12-03 23:25:52 +04:00
# or
bindkey '^f' vi-forward-blank-word
2013-10-26 13:05:17 -03: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-03 23:45:56 +04: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`.