Virtual Buffers

• ‘consult-buffer’: Enhanced version of ‘switch-to-buffer’ with support for virtual buffers. Supports live preview of buffers and narrowing to the virtual buffer types. You can type ‘f SPC’ in order to narrow to recent files. Press ‘SPC’ to show ephemeral buffers. Supported narrowing keys:

  • b Buffers
  • SPC Hidden buffers
  • * Modified buffers
  • o Buffers from other frames/tabs
  • f Files (Requires ‘recentf-mode’)
  • r File and buffer registers
  • m Bookmarks
  • p Project
  • B Project buffers
  • F Project files
  • R Project roots
  • Custom other sources configured in ‘consult-buffer-sources’.

  By default, buffers from all frames are taken into account. The buffers which are taken into account, can be customized by the variable ‘consult-buffer-list-function’. Other buffers are available by pressing ‘o SPC’.

• ‘consult-buffer-other-window’, ‘consult-buffer-other-frame’, ‘consult-buffer-other-tab’: Variants of ‘consult-buffer’.

• ‘consult-project-buffer’: Variant of ‘consult-buffer’ restricted to buffers and recent files of the current project. You can add custom sources to ‘consult-project-buffer-sources’. The command may prompt you for a project if you invoke it from outside a project.

• ‘consult-bookmark’: Select or create bookmark. To select bookmarks you might use the ‘consult-buffer’ as an alternative, which can include a bookmark virtual buffer source. Note that ‘consult-bookmark’ supports preview of bookmarks and narrowing.

• ‘consult-recent-file’: Select from recent files with preview. You might prefer the powerful ‘consult-buffer’ instead, which can include recent files as a virtual buffer source. The ‘recentf-mode’ enables tracking of recent files.