Skip to content

Picker Plugin ​

Help query: "What does the picker plugin do?" / "How do I use picker preview in Volt?" / "How do I open the command palette?"

The picker plugin is Volt's fuzzy/searchable list UI. It opens providers for commands, buffers, keybindings, themes, icon fonts, quickfix, and many subsystem pickers. Preview pickers show a list beside a file/content preview that fills available height (up to the shared repository file preview line cap).

Package namepicker
Moduleuser/picker.rs

What it does ​

  • Open command, buffer, keybinding, theme, and icon-font pickers
  • Navigate picker results and submit/cancel
  • Drive quickfix mark/next/previous workflows
  • Host other packages' picker providers (ACP clients, treesitter languages, workspace projects/switch/files, and more)
  • Show richer previews for buffers and workspace files (path plus body lines, capped at REPOSITORY_FILE_PREVIEW_MAX_LINES = 256)

Layout ​

Defaults from user/picker.rs:

ConstantDefaultMeaning
WIDTH_FRACTION0.8Picker card width as a fraction of the window
HEIGHT_FRACTION0.8Picker card height as a fraction of the window
SPLIT_FRACTION0.5Horizontal divider inside a preview picker (0.0..=1.0)

Label truncation uses truncate_strategy() from user/config/ui.yaml (ui.picker_truncate_strategy).

Commands ​

CommandDescription
picker.open-commandsOpens the command picker popup.
picker.open-buffersOpens the buffer picker popup.
picker.open-keybindingsOpens the keybinding picker popup.
picker.open-themesOpens the theme picker popup.
picker.open-icon-fontsOpens the bundled icon font picker popup.
picker.select-nextMoves to the next picker result.
picker.select-previousMoves to the previous picker result.
picker.submitSubmits the selected picker item.
picker.cancelCancels the picker.
quickfix.openOpens quickfix.
quickfix.nextGoes to the next quickfix match.
quickfix.previousGoes to the previous quickfix match.

Keybindings ​

ChordCommandScope
F3picker.open-commandsGlobal
F4picker.open-buffersGlobal
F6picker.open-themesGlobal
F7picker.open-keybindingsGlobal
Ctrl+npopup.nextPopup
Ctrl+ppopup.previousPopup
Enterpicker.submitPopup
Escapepicker.cancelPopup

Provider extras (examples) ​

ProviderChordCommand
workspace.switchCtrl+dworkspace.delete
workspace.dashboardCtrl+dworkspace.worktree-remove
workspace.searchCtrl+qquickfix.open

Volt — modal editor platform · docs optimized for in-editor help search