robinwobin.dev
minimal extui fuzzy finder for neovim
doc: add readme
+46
+46
README.md
+46
README.md
···
1
+
# artio.nvim
2
+
3
+
A minimal, nature-infused file picker for Neovim using the new extui window.
4
+
Inspired by forest spirits and the calm intuition of hunting, Artio helps you gently select files without the weight of heavy fuzzy-finder dependencies.
5
+
6
+
## features
7
+
8
+
- Lightweight picker window built on Neovim's extui
9
+
- Prompt + list UI components - minimal and focused
10
+
- Fuzzy filtering using matchfuzzy (built-in)
11
+
- No heavy dependencies - pure Lua
12
+
13
+
## installation
14
+
15
+
`vim.pack`
16
+
17
+
```lua
18
+
vim.pack.add({ src = "https://github.com/comfysage/artio.nvim" })
19
+
```
20
+
21
+
`lazy.nvim`
22
+
23
+
```lua
24
+
{
25
+
"comfysage/artio.nvim", lazy = false,
26
+
}
27
+
```
28
+
29
+
## configuration
30
+
31
+
```lua
32
+
require("artio").setup({
33
+
opts = {
34
+
preselect = true,
35
+
bottom = true,
36
+
promptprefix = "",
37
+
pointer = "",
38
+
},
39
+
win = {
40
+
height = 12,
41
+
hidestatusline = false, -- works best with laststatus=3
42
+
},
43
+
})
44
+
45
+
vim.keymap.set("n", "<leader><leader>", "<Plug>(picker-find)")
46
+
```