chosen=$(ls | naru)
echo the user chose $chosen

To achieve this /dev/tty is used for user interaction and stdout for the result.

naru shows its results directly below the cursor position (scrolling the screen upward if necessary). This allows it to be used with editor plugins.

naru keybindings are configurable and it has a unique feature: it allows you to select multiple matches.

The configuration file uses the toml format, here is an example showing the defaults:

[window]
height = 0

[bindings]
c-j = "select-next"
c-k = "select-prev"

For window.height, positive numbers specify the height in lines, 0 means "full height" and the negative number -n means full_height - n.

let g:fuzzy_executable = 'naru'