Dependencies

Optional dependencies

Windows Notes

Buffers and Files

Search

Tags

Git

LSP/Diagnostics

Misc

Neovim API

nvim-dap

tmux

zoxide

Completion Functions

-- Use skim (or a speccific fzf binary/version) instead of fzf?-- fzf_bin = 'sk',-- Padding can help kitty term users with double-width icon renderingfile_icon_padding='',-- Uncomment if your terminal/font does not support unicode character-- 'EN SPACE' (U+2002), the below sets it to 'NBSP' (U+00A0) instead-- nbsp = '\xc2\xa0',-- Function override for opening the help window (default bound to `<F1>`)-- Override this function if you want to customize window config of the-- help window (location, width, border, etc.)help_open_win=vim.api.nvim_open_win,

winopts= {-- split = "belowright new",-- open in a split instead?-- "belowright new"  : split below-- "aboveleft new"   : split above-- "belowright vnew" : split right-- "aboveleft vnew   : split left-- Only valid when using a float window-- (i.e. when 'split' is not defined, default)height=0.85,-- window heightwidth=0.80,-- window widthrow=0.35,-- window row position (0=top, 1=bottom)col=0.50,-- window col position (0=left, 1=right)-- border argument passthrough to nvim_open_win()border="rounded",-- Backdrop opacity, 0 is fully opaque, 100 is fully transparent (i.e. disabled)backdrop=60,-- title         = "Title",-- title_pos     = "center",        -- 'left', 'center' or 'right'-- title_flags   = false,           -- uncomment to disable title flagsfullscreen=false,-- start fullscreen?-- enable treesitter highlighting for the main fzf window will only have-- effect where grep like results are present, i.e. "file:line:col:text"-- due to highlight color collisions will also override `fzf_colors`-- set `fzf_colors=false` or `fzf_colors.hl=...` to overridetreesitter= {enabled=true,fzf_colors= { ["hl"]="-1:reverse", ["hl+"]="-1:reverse"}    },preview= {-- default     = 'bat',           -- override the default previewer?-- default uses the 'builtin' previewerborder="rounded",-- preview border: accepts both `nvim_open_win`-- and fzf values (e.g. "border-top", "none")-- native fzf previewers (bat/cat/git/etc)-- can also be set to `fun(winopts, metadata)`wrap=false,-- preview line wrap (fzf's 'wrap|nowrap')hidden=false,-- start preview hiddenvertical="down:45%",-- up|down:sizehorizontal="right:60%",-- right|left:sizelayout="flex",-- horizontal|vertical|flexflip_columns=100,-- #cols to switch to horizontal on flex-- Only used with the builtin previewer:title=true,-- preview border title (file/buf)?title_pos="center",-- left|center|right, title alignmentscrollbar="float",-- `false` or string:'float|border'-- float:  in-window floating border-- border: in-border "block" markerscrolloff=-1,-- float scrollbar offset from right-- applies only when scrollbar = 'float'delay=20,-- delay(ms) displaying the preview-- prevents lag on fast scrollingwinopts= {-- builtin previewer window optionsnumber=true,relativenumber=false,cursorline=true,cursorlineopt="both",cursorcolumn=false,signcolumn="no",list=false,foldenable=false,foldmethod="manual",      },    },on_create=function()-- called once upon creation of the fzf main window-- can be used to add custom fzf-lua mappings, e.g:--   vim.keymap.set("t", "<C-j>", "<Down>", { silent = true, buffer = true })end,-- called once _after_ the fzf interface is closed-- on_close = function() ... end}

keymap= {-- Below are the default binds, setting any value in these tables will override-- the defaults, to inherit from the defaults change [1] from `false` to `true`builtin= {-- neovim `:tmap` mappings for the fzf win-- true,        -- uncomment to inherit all the below in your custom config      ["<M-Esc>"]="hide",-- hide fzf-lua, `:FzfLua resume` to continue      ["<F1>"]="toggle-help",      ["<F2>"]="toggle-fullscreen",-- Only valid with the 'builtin' previewer      ["<F3>"]="toggle-preview-wrap",      ["<F4>"]="toggle-preview",-- Rotate preview clockwise/counter-clockwise      ["<F5>"]="toggle-preview-cw",-- Preview toggle behavior default/extend      ["<F6>"]="toggle-preview-behavior",-- `ts-ctx` binds require `nvim-treesitter-context`      ["<F7>"]="toggle-preview-ts-ctx",      ["<F8>"]="preview-ts-ctx-dec",      ["<F9>"]="preview-ts-ctx-inc",      ["<S-Left>"]="preview-reset",      ["<S-down>"]="preview-page-down",      ["<S-up>"]="preview-page-up",      ["<M-S-down>"]="preview-down",      ["<M-S-up>"]="preview-up",    },fzf= {-- fzf '--bind=' options-- true,        -- uncomment to inherit all the below in your custom config      ["ctrl-z"]="abort",      ["ctrl-u"]="unix-line-discard",      ["ctrl-f"]="half-page-down",      ["ctrl-b"]="half-page-up",      ["ctrl-a"]="beginning-of-line",      ["ctrl-e"]="end-of-line",      ["alt-a"]="toggle-all",      ["alt-g"]="first",      ["alt-G"]="last",-- Only valid with fzf previewers (bat/cat/git/etc)      ["f3"]="toggle-preview-wrap",      ["f4"]="toggle-preview",      ["shift-down"]="preview-page-down",      ["shift-up"]="preview-page-up",    },},

actions= {-- Below are the default actions, setting any value in these tables will override-- the defaults, to inherit from the defaults change [1] from `false` to `true`files= {-- true,        -- uncomment to inherit all the below in your custom config-- Pickers inheriting these actions:--   files, git_files, git_status, grep, lsp, oldfiles, quickfix, loclist,--   tags, btags, args, buffers, tabs, lines, blines-- `file_edit_or_qf` opens a single selection or sends multiple selection to quickfix-- replace `enter` with `file_edit` to open all files/bufs whether single or multiple-- replace `enter` with `file_switch_or_edit` to attempt a switch in current tab first      ["enter"]=FzfLua.actions.file_edit_or_qf,      ["ctrl-s"]=FzfLua.actions.file_split,      ["ctrl-v"]=FzfLua.actions.file_vsplit,      ["ctrl-t"]=FzfLua.actions.file_tabedit,      ["alt-q"]=FzfLua.actions.file_sel_to_qf,      ["alt-Q"]=FzfLua.actions.file_sel_to_ll,      ["alt-i"]=FzfLua.actions.toggle_ignore,      ["alt-h"]=FzfLua.actions.toggle_hidden,      ["alt-f"]=FzfLua.actions.toggle_follow,    },  }

fzf_opts= {-- options are sent as `<left>=<right>`-- set to `false` to remove a flag-- set to `true` for a no-value flag-- for raw args use `fzf_args` instead    ["--ansi"]=true,    ["--info"]="inline-right",-- fzf < v0.42 = "inline"    ["--height"]="100%",    ["--layout"]="reverse",    ["--border"]="none",    ["--highlight-line"]=true,-- fzf >= v0.53  }-- Only used when fzf_bin = "fzf-tmux", by default opens as a-- popup 80% width, 80% height (note `-p` requires tmux > 3.2)-- and removes the sides margin added by `fzf-tmux` (fzf#3162)-- for more options run `fzf-tmux --help`-- NOTE: since fzf v0.53 / sk v0.15 it is recommended to use-- native tmux integration by adding the below to `fzf_opts`-- fzf_opts = { ["--tmux"] = "center,80%,60%" }fzf_tmux_opts= { ["-p"]="80%,80%", ["--margin"]="0,0"},

---- Set fzf's terminal colorscheme (optional)---- Set to `true` to automatically generate an fzf's colorscheme from-- Neovim's current colorscheme:-- fzf_colors       = true,---- Building a custom colorscheme, has the below specifications:-- If rhs is of type "string" rhs will be passed raw, e.g.:--   `["fg"] = "underline"` will be translated to `--color fg:underline`-- If rhs is of type "table", the following convention is used:--   [1] "what" field to extract from the hlgroup, i.e "fg", "bg", etc.--   [2] Neovim highlight group(s), can be either "string" or "table"--       when type is "table" the first existing highlight group is used--   [3+] any additional fields are passed raw to fzf's command line args-- Example of a "fully loaded" color option:--   `["fg"] = { "fg", { "NonExistentHl", "Comment" }, "underline", "bold" }`-- Assuming `Comment.fg=#010101` the resulting fzf command line will be:--   `--color fg:#010101:underline:bold`-- NOTE: to pass raw arguments `fzf_opts["--color"]` or `fzf_args`-- NOTE: below is an example, not the defaults:fzf_colors= {true,-- inherit fzf colors that aren't specified below from-- the auto-generated theme similar to `fzf_colors=true`      ["fg"]= {"fg","CursorLine"},      ["bg"]= {"bg","Normal"},      ["hl"]= {"fg","Comment"},      ["fg+"]= {"fg","Normal","underline"},      ["bg+"]= {"bg", {"CursorLine","Normal"} },      ["hl+"]= {"fg","Statement"},      ["info"]= {"fg","PreProc"},      ["prompt"]= {"fg","Conditional"},      ["pointer"]= {"fg","Exception"},      ["marker"]= {"fg","Keyword"},      ["spinner"]= {"fg","Label"},      ["header"]= {"fg","Comment"},      ["gutter"]="-1",  },

hls= {normal="Normal"-- highlight group for normal fg/bgpreview_normal="Normal"-- highlight group for preview fg/bg...}

previewers= {cat= {cmd="cat",args="-n",    },bat= {cmd="bat",args="--color=always --style=numbers,changes",    },head= {cmd="head",args=nil,    },git_diff= {-- if required, use `{file}` for argument positioning-- e.g. `cmd_modified = "git diff --color HEAD {file} | cut -c -30"`cmd_deleted="git diff --color HEAD --",cmd_modified="git diff --color HEAD",cmd_untracked="git diff --color --no-index /dev/null",-- git-delta is automatically detected as pager, set `pager=false`-- to disable, can also be set under 'git.status.preview_pager'    },man= {-- NOTE: remove the `-c` flag when using man-db-- replace with `man -P cat %s | col -bx` on OSXcmd="man -c %s | col -bx",    },builtin= {syntax=true,-- preview syntax highlight?syntax_limit_l=0,-- syntax limit (lines), 0=nolimitsyntax_limit_b=1024*1024,-- syntax limit (bytes), 0=nolimitlimit_b=1024*1024*10,-- preview limit (bytes), 0=nolimit-- previewer treesitter options:-- enable specific filetypes with: `{ enabled = { "lua" } }-- exclude specific filetypes with: `{ disabled = { "lua" } }-- disable `nvim-treesitter-context` with `context = false`-- disable fully with: `treesitter = false` or `{ enabled = false }`treesitter= {enabled=true,disabled= {},-- nvim-treesitter-context config optionscontext= {max_lines=1,trim_scope="inner"}      },-- By default, the main window dimensions are calculated as if the-- preview is visible, when hidden the main window will extend to-- full size. Set the below to "extend" to prevent the main window-- from being modified when toggling the preview.toggle_behavior="default",-- Title transform function, by default only displays the tail-- title_fnamemodify = function(s) return vim.fn.fnamemodify(s, ":t") end,-- preview extensions using a custom shell command:-- for example, use `viu` for image previews-- will do nothing if `viu` isn't executableextensions= {-- neovim terminal only supports `viu` block output        ["png"]= {"viu","-b"},-- by default the filename is added as last argument-- if required, use `{file}` for argument positioning        ["svg"]= {"chafa","{file}"},        ["jpg"]= {"ueberzug"},      },-- if using `ueberzug` in the above extensions map-- set the default image scaler, possible scalers:--   false (none), "crop", "distort", "fit_contain",--   "contain", "forced_cover", "cover"-- https://github.com/seebye/ueberzugueberzug_scaler="cover",-- render_markdown.nvim integration, enabled by default for markdownrender_markdown= {enabled=true,filetypes= { ["markdown"]=true } },-- snacks.images integration, enabled by defaultsnacks_image= {enabled=true,render_inline=true },    },-- Code Action previewers, default is "codeaction" (set via `lsp.code_actions.previewer`)-- "codeaction_native" uses fzf's native previewer, recommended when combined with git-deltacodeaction= {-- options for vim.diff(): https://neovim.io/doc/user/lua.html#vim.diff()diff_opts= {ctxlen=3 },    },codeaction_native= {diff_opts= {ctxlen=3 },-- git-delta is automatically detected as pager, set `pager=false`-- to disable, can also be set under 'lsp.code_actions.preview_pager'-- recommended styling for delta--pager = [[delta --width=$COLUMNS --hunk-header-style="omit" --file-style="omit"]],    },}

-- use `defaults` (table or function) if you wish to set "global-picker" defaults-- for example, using "mini.icons" globally and open the quickfix list at the top--   defaults = {--     file_icons   = "mini",--     copen        = "topleft copen",--   },files= {-- previewer      = "bat",          -- uncomment to override previewer-- (name from 'previewers' table)-- set to 'false' to disableprompt='Files❯',multiprocess=true,-- run command in a separate processgit_icons=false,-- show git icons?file_icons=true,-- show file icons (true|"devicons"|"mini")?color_icons=true,-- colorize file|git icons-- path_shorten   = 1,              -- 'true' or number, shorten path?-- Uncomment for custom vscode-like formatter where the filename is first:-- e.g. "fzf-lua/previewer/fzf.lua" => "fzf.lua previewer/fzf-lua"-- formatter      = "path.filename_first",-- executed command priority is 'cmd' (if exists)-- otherwise auto-detect prioritizes `fd`:`rg`:`find`-- default options are controlled by 'fd|rg|find|_opts'-- cmd            = "rg --files",find_opts=[[-type f \! -path '*/.git/*']],rg_opts=[[--color=never --hidden --files -g "!.git"]],fd_opts=[[--color=never --hidden --type f --type l --exclude .git]],dir_opts=[[/s/b/a:-d]],-- by default, cwd appears in the header only if {opts} contain a cwd-- parameter to a different folder than the current working directory-- uncomment if you wish to force display of the cwd as part of the-- query prompt string (fzf.vim style), header line or both-- cwd_header = true,cwd_prompt=true,cwd_prompt_shorten_len=32,-- shorten prompt beyond this lengthcwd_prompt_shorten_val=1,-- shortened path parts lengthtoggle_ignore_flag="--no-ignore",-- flag toggled in `actions.toggle_ignore`toggle_hidden_flag="--hidden",-- flag toggled in `actions.toggle_hidden`toggle_follow_flag="-L",-- flag toggled in `actions.toggle_follow`hidden=true,-- enable hidden files by defaultfollow=false,-- do not follow symlinks by defaultno_ignore=false,-- respect ".gitignore"  by defaultabsolute_path=false,-- display absolute pathsactions= {-- inherits from 'actions.files', here we can override-- or set bind to 'false' to disable a default action-- uncomment to override `actions.file_edit_or_qf`--   ["enter"]     = actions.file_edit,-- custom actions are available too--   ["ctrl-y"]    = function(selected) print(selected[1]) end,    }  },git= {files= {prompt='GitFiles❯',cmd='git ls-files --exclude-standard',multiprocess=true,-- run command in a separate processgit_icons=true,-- show git icons?file_icons=true,-- show file icons (true|"devicons"|"mini")?color_icons=true,-- colorize file|git icons-- force display the cwd header line regardless of your current working-- directory can also be used to hide the header when not wanted-- cwd_header = true    },status= {prompt='GitStatus❯',cmd="git -c color.status=false --no-optional-locks status --porcelain=v1 -u",multiprocess=true,-- run command in a separate processfile_icons=true,color_icons=true,previewer="git_diff",-- git-delta is automatically detected as pager, uncomment to disable-- preview_pager = false,actions= {-- actions inherit from 'actions.files' and merge        ["right"]= {fn=actions.git_unstage,reload=true },        ["left"]= {fn=actions.git_stage,reload=true },        ["ctrl-x"]= {fn=actions.git_reset,reload=true },      },-- If you wish to use a single stage|unstage toggle instead-- using 'ctrl-s' modify the 'actions' table as shown below-- actions = {--   ["right"]   = false,--   ["left"]    = false,--   ["ctrl-x"]  = { fn = actions.git_reset, reload = true },--   ["ctrl-s"]  = { fn = actions.git_stage_unstage, reload = true },-- },    },diff= {cmd="git --no-pager diff --name-only {ref}",ref="HEAD",preview="git diff {ref} {file}",-- git-delta is automatically detected as pager, uncomment to disable-- preview_pager = false,file_icons=true,color_icons=true,fzf_opts= { ["--multi"]=true },    },hunks= {cmd="git --no-pager diff --color=always {ref}",ref="HEAD",file_icons=true,color_icons=true,fzf_opts= {      ["--multi"]=true,      ["--delimiter"]=":",      ["--nth"]="3..",      },    },commits= {prompt='Commits❯',cmd=[[git log --color --pretty=format:"%C(yellow)%h%Creset]]..[[%Cgreen(%><(12)%cr%><|(12))%Creset %s %C(blue)<%an>%Creset"]],preview="git show --color {1}",-- git-delta is automatically detected as pager, uncomment to disable-- preview_pager = false,actions= {        ["enter"]=actions.git_checkout,-- remove `exec_silent` or set to `false` to exit after yank        ["ctrl-y"]= {fn=actions.git_yank_commit,exec_silent=true },      },    },bcommits= {prompt='BCommits❯',-- default preview shows a git diff vs the previous commit-- if you prefer to see the entire commit you can use:--   git show --color {1} --rotate-to={file}--   {1}    : commit SHA (fzf field index expression)--   {file} : filepath placement within the commandscmd=[[git log --color --pretty=format:"%C(yellow)%h%Creset]]..[[%Cgreen(%><(12)%cr%><|(12))%Creset %s %C(blue)<%an>%Creset" {file}]],preview="git show --color {1} -- {file}",-- git-delta is automatically detected as pager, uncomment to disable-- preview_pager = false,actions= {        ["enter"]=actions.git_buf_edit,        ["ctrl-s"]=actions.git_buf_split,        ["ctrl-v"]=actions.git_buf_vsplit,        ["ctrl-t"]=actions.git_buf_tabedit,        ["ctrl-y"]= {fn=actions.git_yank_commit,exec_silent=true },      },    },blame= {prompt="Blame>",cmd=[[git blame --color-lines {file}]],preview="git show --color {1} -- {file}",-- git-delta is automatically detected as pager, uncomment to disable-- preview_pager = false,actions= {        ["enter"]=actions.git_goto_line,        ["ctrl-s"]=actions.git_buf_split,        ["ctrl-v"]=actions.git_buf_vsplit,        ["ctrl-t"]=actions.git_buf_tabedit,        ["ctrl-y"]= {fn=actions.git_yank_commit,exec_silent=true },      },    },branches= {prompt='Branches❯',cmd="git branch --all --color",preview="git log --graph --pretty=oneline --abbrev-commit --color {1}",remotes="local",-- "detach|local", switch behavior for remotesactions= {        ["enter"]=actions.git_switch,        ["ctrl-x"]= {fn=actions.git_branch_del,reload=true },        ["ctrl-a"]= {fn=actions.git_branch_add,field_index="{q}",reload=true },      },-- If you wish to add branch and switch immediately-- cmd_add  = { "git", "checkout", "-b" },cmd_add= {"git","branch"},-- If you wish to delete unmerged branches add "--force"-- cmd_del  = { "git", "branch", "--delete", "--force" },cmd_del= {"git","branch","--delete"},    },tags= {prompt="Tags>",cmd=[[git for-each-ref --color --sort="-taggerdate" --format]]..[["%(color:yellow)%(refname:short)%(color:reset)]]..[[%(color:green)(%(taggerdate:relative))%(color:reset)]]..[[ %(subject) %(color:blue)%(taggername)%(color:reset)" refs/tags]],preview=[[git log --graph --color --pretty=format:"%C(yellow)%h%Creset]]..[[%Cgreen(%><(12)%cr%><|(12))%Creset %s %C(blue)<%an>%Creset" {1}]],actions= { ["enter"]=actions.git_checkout },    },stash= {prompt='Stash>',cmd="git --no-pager stash list",preview="git --no-pager stash show --patch --color {1}",actions= {        ["enter"]=actions.git_stash_apply,        ["ctrl-x"]= {fn=actions.git_stash_drop,reload=true },      },    },icons= {      ["M"]= {icon="M",color="yellow"},      ["D"]= {icon="D",color="red"},      ["A"]= {icon="A",color="green"},      ["R"]= {icon="R",color="yellow"},      ["C"]= {icon="C",color="yellow"},      ["T"]= {icon="T",color="magenta"},      ["?"]= {icon="?",color="magenta"},-- override git icons?-- ["M"]        = { icon = "★", color = "red" },-- ["D"]        = { icon = "✗", color = "red" },-- ["A"]        = { icon = "+", color = "green" },    },  },grep= {prompt='Rg❯',input_prompt='Grep For❯',multiprocess=true,-- run command in a separate processgit_icons=false,-- show git icons?file_icons=true,-- show file icons (true|"devicons"|"mini")?color_icons=true,-- colorize file|git icons-- executed command priority is 'cmd' (if exists)-- otherwise auto-detect prioritizes `rg` over `grep`-- default options are controlled by 'rg|grep_opts'-- cmd            = "rg --vimgrep",grep_opts="--binary-files=without-match --line-number --recursive --color=auto --perl-regexp -e",rg_opts="--column --line-number --no-heading --color=always --smart-case --max-columns=4096 -e",hidden=false,-- disable hidden files by defaultfollow=false,-- do not follow symlinks by defaultno_ignore=false,-- respect ".gitignore"  by default-- Uncomment to use the rg config file `$RIPGREP_CONFIG_PATH`-- RIPGREP_CONFIG_PATH = vim.env.RIPGREP_CONFIG_PATH---- Set to 'true' to always parse globs in both 'grep' and 'live_grep'-- search strings will be split using the 'glob_separator' and translated-- to '--iglob=' arguments, requires 'rg'-- can still be used when 'false' by calling 'live_grep_glob' directlyrg_glob=true,-- default to glob parsing with `rg`glob_flag="--iglob",-- for case sensitive globs use '--glob'glob_separator="%s%-%-",-- query separator pattern (lua): ' --'-- advanced usage: for custom argument parsing define-- 'rg_glob_fn' to return a pair:--   first returned argument is the new search query--   second returned argument are additional rg flags-- rg_glob_fn = function(query, opts)--   ...--   return new_query, flags-- end,---- Enable with narrow term width, split results to multiple lines-- NOTE: multiline requires fzf >= v0.53 and is ignored otherwise-- multiline      = 1,      -- Display as: PATH:LINE:COL\nTEXT-- multiline      = 2,      -- Display as: PATH:LINE:COL\nTEXT\nactions= {-- actions inherit from 'actions.files' and merge-- this action toggles between 'grep' and 'live_grep'      ["ctrl-g"]= {actions.grep_lgrep }-- uncomment to enable '.gitignore' toggle for grep-- ["ctrl-r"]   = { actions.toggle_ignore }    },no_header=false,-- hide grep|cwd header?no_header_i=false,-- hide interactive header?  },args= {prompt='Args❯',files_only=true,-- actions inherit from 'actions.files' and mergeactions= { ["ctrl-x"]= {fn=actions.arg_del,reload=true } },  },oldfiles= {prompt='History❯',cwd_only=false,stat_file=true,-- verify files exist on disk-- can also be a lua function, for example:-- stat_file = FzfLua.utils.file_is_readable,-- stat_file = function() return true end,include_current_session=false,-- include bufs from current session  },buffers= {prompt='Buffers❯',file_icons=true,-- show file icons (true|"devicons"|"mini")?color_icons=true,-- colorize file|git iconssort_lastused=true,-- sort buffers() by last usedshow_unloaded=true,-- show unloaded bufferscwd_only=false,-- buffers for the cwd onlycwd=nil,-- buffers list for a given diractions= {-- actions inherit from 'actions.files' and merge-- by supplying a table of functions we're telling-- fzf-lua to not close the fzf window, this way we-- can resume the buffers picker on the same window-- eliminating an otherwise unaesthetic win "flash"      ["ctrl-x"]= {fn=actions.buf_del,reload=true },    }  },tabs= {prompt='Tabs❯',tab_title="Tab",tab_marker="<<",locate=true,-- position cursor at current windowfile_icons=true,-- show file icons (true|"devicons"|"mini")?color_icons=true,-- colorize file|git iconsactions= {-- actions inherit from 'actions.files' and merge      ["enter"]=actions.buf_switch,      ["ctrl-x"]= {fn=actions.buf_del,reload=true },    },fzf_opts= {-- hide tabnr      ["--delimiter"]="[\\):]",      ["--with-nth"]='2..',    },  },-- `blines` has the same defaults as `lines` aside from prompt and `show_bufname`lines= {prompt='Lines❯',file_icons=true,show_bufname=true,-- display buffer nameshow_unloaded=true,-- show unloaded buffersshow_unlisted=false,-- exclude 'help' buffersno_term_buffers=true,-- exclude 'term' bufferssort_lastused=true,-- sort by most recentwinopts= {treesitter=true },-- enable TS highlightsfzf_opts= {-- do not include bufnr in fuzzy matching-- tiebreak by line no.      ["--multi"]=true,      ["--delimiter"]="[\t]",      ["--tabstop"]="1",      ["--tiebreak"]="index",      ["--with-nth"]="2..",      ["--nth"]="4..",    },  },tags= {prompt='Tags❯',ctags_file=nil,-- auto-detect from tags-optionmultiprocess=true,file_icons=true,color_icons=true,-- 'tags_live_grep' options, `rg` prioritizes over `grep`rg_opts="--no-heading --color=always --smart-case",grep_opts="--color=auto --perl-regexp",fzf_opts= { ["--tiebreak"]="begin"},actions= {-- actions inherit from 'actions.files' and merge-- this action toggles between 'grep' and 'live_grep'      ["ctrl-g"]= {actions.grep_lgrep }    },no_header=false,-- hide grep|cwd header?no_header_i=false,-- hide interactive header?  },btags= {prompt='BTags❯',ctags_file=nil,-- auto-detect from tags-optionctags_autogen=true,-- dynamically generate ctags each callmultiprocess=true,file_icons=false,rg_opts="--color=never --no-heading",grep_opts="--color=never --perl-regexp",fzf_opts= { ["--tiebreak"]="begin"},-- actions inherit from 'actions.files'  },colorschemes= {prompt='Colorschemes❯',live_preview=true,-- apply the colorscheme on preview?actions= { ["enter"]=actions.colorscheme },winopts= {height=0.55,width=0.30, },-- uncomment to ignore colorschemes names (lua patterns)-- ignore_patterns   = { "^delek$", "^blue$" },  },awesome_colorschemes= {prompt='Colorschemes❯',live_preview=true,-- apply the colorscheme on preview?max_threads=5,-- max download/update threadswinopts= {row=0,col=0.99,width=0.50 },fzf_opts= {      ["--multi"]=true,      ["--delimiter"]="[:]",      ["--with-nth"]="3..",      ["--tiebreak"]="index",    },actions= {      ["enter"]=actions.colorscheme,      ["ctrl-g"]= {fn=actions.toggle_bg,exec_silent=true },      ["ctrl-r"]= {fn=actions.cs_update,reload=true },      ["ctrl-x"]= {fn=actions.cs_delete,reload=true },    },  },keymaps= {prompt="Keymaps>",winopts= {preview= {layout="vertical"} },fzf_opts= { ["--tiebreak"]="index", },-- by default, we ignore <Plug> and <SNR> mappings-- set `ignore_patterns = false` to disable filteringignore_patterns= {"^<SNR>","^<Plug>"},show_desc=true,show_details=true,actions= {      ["enter"]=actions.keymap_apply,      ["ctrl-s"]=actions.keymap_split,      ["ctrl-v"]=actions.keymap_vsplit,      ["ctrl-t"]=actions.keymap_tabedit,    },  },nvim_options= {prompt="Nvim Options>",separator="│",-- separator between option name and valuecolor_values=true,-- colorize boolean valuesactions= {      ["enter"]= {fn=actions.nvim_opt_edit_local,reload=true },      ["alt-enter"]= {fn=actions.nvim_opt_edit_global,reload=true },    },  },quickfix= {file_icons=true,valid_only=false,-- select among only the valid quickfix entries  },quickfix_stack= {prompt="Quickfix Stack>",marker=">",-- current list marker  },lsp= {prompt_postfix='❯',-- will be appended to the LSP label-- to override use 'prompt' insteadcwd_only=false,-- LSP/diagnostics for cwd only?async_or_timeout=5000,-- timeout(ms) or 'true' for async callsfile_icons=true,git_icons=false,jump1=true,-- skip the UI when result is a single entryjump1_action=FzfLua.actions.file_edit-- The equivalent of using `includeDeclaration` in lsp buf calls, e.g:-- :lua vim.lsp.buf.references({includeDeclaration = false})includeDeclaration=true,-- include current declaration in LSP context-- settings for 'lsp_{document|workspace|lsp_live_workspace}_symbols'symbols= {-- lsp_query      = "foo"       -- query passed to the LSP directly-- query          = "bar"       -- query passed to fzf prompt for fuzzy matchinglocate=false,-- attempt to position cursor at current symbolasync_or_timeout=true,-- symbols are async by defaultsymbol_style=1,-- style for document/workspace symbols-- false: disable,    1: icon+kind--     2: icon only,  3: kind only-- NOTE: icons are extracted from-- vim.lsp.protocol.CompletionItemKind-- icons for symbol kind-- see https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#symbolKind-- see https://github.com/neovim/neovim/blob/829d92eca3d72a701adc6e6aa17ccd9fe2082479/runtime/lua/vim/lsp/protocol.lua#L117symbol_icons= {File="󰈙",Module="",Namespace="󰦮",Package="",Class="󰆧",Method="󰊕",Property="",Field="",Constructor="",Enum="",Interface="",Function="󰊕",Variable="󰀫",Constant="󰏿",String="",Number="󰎠",Boolean="󰨙",Array="󱡠",Object="",Key="󰌋",Null="󰟢",EnumMember="",Struct="󰆼",Event="",Operator="󰆕",TypeParameter="󰗴",        },-- colorize using Treesitter '@' highlight groups ("@function", etc).-- or 'false' to disable highlightingsymbol_hl=function(s)return"@"..s:lower()end,-- additional symbol formatting, works with or without stylesymbol_fmt=function(s,opts)return"["..s.."]"end,-- prefix child symbols. set to any string or `false` to disablechild_prefix=true,-- prepend parent to symbol, set to any string or `false` to disable-- parent_postfix    = ".",fzf_opts= { ["--tiebreak"]="begin"},    },code_actions= {prompt='Code Actions>',async_or_timeout=5000,-- when git-delta is installed use "codeaction_native" for beautiful diffs-- try it out with `:FzfLua lsp_code_actions previewer=codeaction_native`-- scroll up to `previewers.codeaction{_native}` for more previewer optionspreviewer="codeaction",    },finder= {prompt="LSP Finder>",file_icons=true,color_icons=true,async=true,-- async by defaultsilent=true,-- suppress "not found"separator="|",-- separator after provider prefix, `false` to disableincludeDeclaration=true,-- include current declaration in LSP context-- by default display all LSP locations-- to customize, duplicate table and delete unwanted providersproviders= {            {"references",prefix=FzfLua.utils.ansi_codes.blue("ref") },            {"definitions",prefix=FzfLua.utils.ansi_codes.green("def") },            {"declarations",prefix=FzfLua.utils.ansi_codes.magenta("decl") },            {"typedefs",prefix=FzfLua.utils.ansi_codes.red("tdef") },            {"implementations",prefix=FzfLua.utils.ansi_codes.green("impl") },            {"incoming_calls",prefix=FzfLua.utils.ansi_codes.cyan("in") },            {"outgoing_calls",prefix=FzfLua.utils.ansi_codes.yellow("out") },            {"type_sub",prefix=FzfLua.utils.utils.ansi_codes.cyan("sub") },            {"type_super",prefix=FzfLua.utils.utils.ansi_codes.yellow("supr") },        },    }  },diagnostics={prompt='Diagnostics❯',cwd_only=false,file_icons=false,git_icons=false,color_headings=true,-- use diag highlights to color source & filepathdiag_icons=true,-- display icons from diag sign definitionsdiag_source=true,-- display diag source (e.g. [pycodestyle])diag_code=true,-- display diag code (e.g. [undefined])icon_padding='',-- add padding for wide diagnostics signsmultiline=2,-- split heading and diag to separate lines-- severity_only:   keep any matching exact severity-- severity_limit:  keep any equal or more severe (lower)-- severity_bound:  keep any equal or less severe (higher)  },marks= {marks="",-- filter vim marks with a lua pattern-- for example if you want to only show user defined marks-- you would set this option as %a this would match characters from [A-Za-z]-- or if you want to show only numbers you would set the pattern to %d (0-9).  },complete_path= {cmd=nil,-- default: auto detect fd|rg|findcomplete= { ["enter"]=actions.complete },word_pattern=nil,-- default: "[^%s\"']*"  },complete_file= {cmd=nil,-- default: auto detect rg|fd|findfile_icons=true,color_icons=true,word_pattern=nil,-- actions inherit from 'actions.files' and mergeactions= { ["enter"]=actions.complete },-- previewer hidden by defaultwinopts= {preview= {hidden=true } },  },zoxide= {cmd="zoxide query --list --score",scope="global",-- cd action scope "local|win|tab"git_root=false,-- auto-detect git rootformatter="path.dirname_first",fzf_opts= {      ["--no-multi"]=true,      ["--delimiter"]="[\t]",      ["--tabstop"]="4",      ["--tiebreak"]="end,index",-- prefer dirs ending with search term      ["--nth"]="2..",-- exclude score from fuzzy matching    },actions= {enter=actions.cd }  },-- uncomment to use fzf native previewers-- (instead of using a neovim floating window)-- manpages = { previewer = "man_native" },-- helptags = { previewer = "help_native" },

Inline Customization

:luaFzfLua.files({fzf_opts= {['--layout']='reverse-list'} })-- Or via the vimL command:FzfLuafilesfzf_opts.--layout=reverse-list

:luaFzfLua.files({prompt="LS>",cmd="ls",cwd="~/.config"})-- Or via the vimL command:FzfLuafilesprompt="LS>\"cmd=lscwd=~/.config

:luaFzfLua.live_grep({cmd="git grep --line-number --column --color=always"})

:luaFzfLua.spell_suggest({winopts= {height=0.33,width=0.33,relative="cursor"} })-- Or via the vimL command:FzfLuaspell_suggestwinopts={height=0.33,width=0.33,relative=cursor}:FzfLuaspell_suggestwinopts={height=0.33,width=0.33}winopts.relative=cursor

Available Profiles

Custom Completion

FzfLua.fzf_exec({"foo","bar"}, {complete=true})

FzfLua.fzf_exec({"foo","bar"}, {-- @param selected: the selected entry or entries-- @param opts: fzf-lua caller/provider options-- @param line: originating buffer completed line-- @param col: originating cursor column location-- @return newline: will replace the current buffer line-- @return newcol?: optional, sets the new cursor columncomplete=function(selected,opts,line,col)localnewline=line:sub(1,col)..selected[1]-- set cursor to EOL, since `nvim_win_set_cursor`-- is 0-based we have to lower the col value by 1returnnewline,#newline-1end})

Highlight groups

Fzf Colors

require("fzf-lua").setup({fzf_colors=true })-- Or in the direct call options:luaFzfLua.files({fzf_colors=true }):FzfLuafilesfzf_colors=true

require('fzf-lua').setup {fzf_colors= {-- First existing highlight group will be used-- values in 3rd+ index will be passed raw-- i.e:  `--color fg+:#010101:bold:underline`    ["fg+"]= {"fg", {"Comment","Normal"},"bold","underline"},-- It is also possible to pass raw values directly    ["gutter"]="-1"  }}

-- Similarly, first existing highlight group will be used:luavim.g.fzf_colors= { ["gutter"]= {"bg","DoesNotExist","IncSearch"} }

:luavim.g.fzf_colors= { ["fg+"]= {"fg", {"ErrorMsg"},"bold","underline"} }