Add a doc describing how to add custom suggestion strategies. This was very hard to figure out without guidance.

Zane McCaig 2023-05-27 18:17:26 -07:00
parent 0e9c681339
commit cf89251fbe

@ -0,0 +1,16 @@
## Adding a Custom Suggestion Strategy
1. Add a `_zsh_autosuggest_strategy_<your custom strategy name>` function to your `.zshrc`. It must set the global variable `suggestion`
2. Export the `ZSH_AUTOSUGGEST_STRATEGY`
#### Example
This example applies the history strategy first and if it fails to find a match then it applies the custom strategy
```
_zsh_autosuggest_strategy_custom() {
typeset -g suggestion
suggestion=`./my-custom-suggestion-script.sh "$1"`
}
export ZSH_AUTOSUGGEST_STRATEGY=(history custom)
```