Picker & marginalia The picker: :picker (files, grep, buffers, lines, outline, …) — one vertico-style fuzzy finder over every source, with typed marginalia columns and syntax-highlighted previews.File tree file-tree-mode: a hierarchical, read-only directory view — expand/collapse subdirectories, to open a file, - to hand off to oil-mode for editing. Oil — editable directories oil-mode: a flat, writable directory listing — edit the buffer like text, :w runs the diff as filesystem operations (rename / create / delete). Project search Project-wide search: :search streams matches into a multibuffer; g/{motion} greps a motion's text; jumps to source, gr refreshes. Multibuffer views Multibuffer views: excerpts from many files composed into one editable buffer — the substrate behind search results and project-wide diff. Narrow Focus on a region with the zn operator or :narrow; edit in the view, changes flow to the source; :widen restores. Stacked narrow is always one hop. Scan views Scan views: a plugin's own command walks your files, asks a scan source which rows they carry, and collects the answers into one ordered multibuffer; jumps to source, gr rescans. The clock report scan-view-clockreport-mode: cr puts a clock report at the top of a scan view — clocked time totalled up the outline, with own time beside each total. Pickers, one by one Each picker's own page — the one <C-h> opens inside it.
Topic What it covers The files picker picker-files: fuzzy-find a file under the project root and open it — :files [root]. The file-pick picker picker-file-pick: choose a file and hand its path to whatever asked — the files list, as a value instead of an open. The dir-pick picker picker-dir-pick: browse the filesystem one directory at a time and choose a directory — goes in, comes back out. The recent picker picker-recent: the files you have edited this session, newest first — :recent. The buffer picker picker-buffers: switch to an open buffer by name — :b, :buffers, <C-x>b. The grep picker picker-grep: live project-wide text search — hits re-run as you type, jumps to one, sends them all to the error list. The lines picker picker-lines: fuzzy-filter the current buffer's lines and jump to one, with the buffer previewed in place. The outline picker picker-outline: jump to a function, type or other symbol in the current buffer, from its tree-sitter outline. The jumps picker picker-jumps: the position history — jump list and mark ring in one — newest first; jumps back to any point. The marks picker picker-marks: every mark you have set, by name; jumps to it like a backtick. The registers picker picker-registers: see every register's contents on one line each and paste the one you pick, like \"xp. The yank-ring picker picker-yank-ring: pick anything you recently yanked or deleted and insert it where you are — the buffer, the : or / line, or another picker's query. The commands picker picker-commands: the command palette — every ex-command with its key, arguments and doc; runs it or opens the : line for its arguments. The history picker picker-history: every : command you have run, newest first; puts it back on the : line to edit — it does not run it. The search-history picker picker-search-history: every / pattern you have searched, newest first; puts it back on the search line to edit — it does not search. The pane-buffer-history picker picker-pane-buffer-history: the buffers THIS pane has shown, newest first; walks back to one without losing the way forward. The snippets picker picker-snippets: browse the snippets for this buffer's language and expand one at the cursor. The colorscheme picker picker-colorscheme: try every theme live as you move through the list; keeps one, puts yours back. The magit pickers picker-magit: the pickers magit opens when a command needs you to name a branch, commit, tag, ref, remote, revision or stash. The LSP result pickers picker-lsp-locations: the list the language server's answers open in — definitions, references, symbols, call and type hierarchies, diagnostics, and code actions. The LSP server picker picker-lsp-instances: choose which running language server's log or protocol trace to open, when more than one matches. A language server's question picker-lsp-message-request: a language server is asking you a question — pick an answer, or to answer none. The AI session picker picker-ai-sessions: choose which AI agent session's log to open, when more than one is running.