GNU-devel ELPA - bufferlo

You can integrate bufferlo with consult-buffer.

This is an example configuration:

(defvar my-consult--source-buffer
  `(:name "Other Buffers"
    :narrow   ?b
    :category buffer
    :face     consult-buffer
    :history  buffer-name-history
    :state    ,#'consult--buffer-state
    :items ,(lambda () (consult--buffer-query
			:predicate #'bufferlo-non-local-buffer-p
			:sort 'visibility
			:as #'buffer-name)))
    "Non-local buffer candidate source for `consult-buffer'.")

(defvar my-consult--source-local-buffer
  `(:name "Local Buffers"
    :narrow   ?l
    :category buffer
    :face     consult-buffer
    :history  buffer-name-history
    :state    ,#'consult--buffer-state
    :default  t
    :items ,(lambda () (consult--buffer-query
			:predicate #'bufferlo-local-buffer-p
			:sort 'visibility
			:as #'buffer-name)))
    "Local buffer candidate source for `consult-buffer'.")

(setq consult-buffer-sources '(consult--source-hidden-buffer
			       my-consult--source-local-buffer
			       my-consult--source-buffer
			       ;; ... other sources ...
			       ))

Fig.1: All buffers are shown; the local buffers are grouped separately.

You can also configure consult-buffer to hide the non-local buffers by default:

(defvar my-consult--source-buffer
  `(:name "All Buffers"
    :narrow   ?a
    :hidden   t
    :category buffer
    :face     consult-buffer
    :history  buffer-name-history
    :state    ,#'consult--buffer-state
    :items ,(lambda () (consult--buffer-query
			:sort 'visibility
			:as #'buffer-name)))
  "All buffer candidate source for `consult-buffer'.")

(defvar my-consult--source-local-buffer
  `(:name nil
    :narrow   ?b
    :category buffer
    :face     consult-buffer
    :history  buffer-name-history
    :state    ,#'consult--buffer-state
    :default  t
    :items ,(lambda () (consult--buffer-query
			:predicate #'bufferlo-local-buffer-p
			:sort 'visibility
			:as #'buffer-name)))
  "Local buffer candidate source for `consult-buffer'.")

(setq consult-buffer-sources '(consult--source-hidden-buffer
			       my-consult--source-buffer
			       my-consult--source-local-buffer
			       ;; ... other sources ...
			       ))

Fig.2: By entering 'a'+<space>, the global buffer list is shown ("All Buffers").

A good alternative is to bind space to "All Buffers" (via :narrow 32). By default, space is used for hidden buffers (consult--source-hidden-buffer). If you still need the hidden buffer list, you can make a new source for it, for example, with period as the narrowing key (:narrow ?.).

You can also integrate bufferlo with ivy.

(defun ivy-bufferlo-switch-buffer ()
  "Switch to another local buffer.
If the prefix arument is given, include all buffers."
    (interactive)
    (if current-prefix-arg
	(ivy-switch-buffer)
      (ivy-read "Switch to local buffer: " #'internal-complete-buffer
		:predicate (lambda (b) (bufferlo-local-buffer-p (cdr b)))
		:keymap ivy-switch-buffer-map
		:preselect (buffer-name (other-buffer (current-buffer)))
		:action #'ivy--switch-buffer-action
		:matcher #'ivy--switch-buffer-matcher
		:caller 'ivy-switch-buffer)))

Bufferlo lets you bookmark the current editing state of individual frames and tabs (windows and local buffers, i.e., the "session"). This allows persisting and restoring the state of a frame or tab within or between Emacs sessions.

This feature has similarities to activities.el and bookmark-view but with awareness of bufferlo's local buffer list.

A tab bookmark includes the tab's window configuration, the local buffer list, and the state (not the contents) of all bookmarkable local buffers. A frame bookmark saves the entire frame with all its tabs and their states.

The state of non-bookmarkable buffers is not saved. However, when still open, they are included in the restored tab/frame.

Tab bookmark functions:

• bufferlo-bookmark-tab-save: Save the current tab as a bookmark.
• bufferlo-bookmark-tab-load: Load a tab bookmark. This replaces the current tab.
• bufferlo-bookmark-tab-save-current: Save the current tab to its associated bookmark (*).
• bufferlo-bookmark-tab-load-current: Load the current tab from its associated bookmark (*).

Frame bookmark functions:

• bufferlo-bookmark-frame-save: Save the current frame as a bookmark.
• bufferlo-bookmark-frame-load: Load a frame bookmark. This replaces the current frame.
• bufferlo-bookmark-frame-save-current: Save the current frame to its associated bookmark (*).
• bufferlo-bookmark-frame-load-current: Load the current frame from its associated bookmark (*).

Restoring bookmarks correctly handles renamed buffers with unchanged file association (e.g., when Emacs had to "uniquify" buffer names).

(*) The associated bookmark is the bookmark from which the frame/tab was loaded or to which it was saved.

By default, the currently active buffer is shown in a newly created tab, so this buffer inevitably ends up in the new tab's local list. You can change the initial buffer by customizing tab-bar-new-tab-choice:

(setq tab-bar-new-tab-choice "*scratch*")

This lets new tabs always start with the scratch buffer.

You can also create a local scratch buffer for each tab:

(setq tab-bar-new-tab-choice #'bufferlo-create-local-scratch-buffer)

You can customize the name of the local scratch buffers by setting bufferlo-local-scratch-buffer-name accordingly.

The same can be achieved for new frames. Use this to set the scratch buffer as the initial buffer for new frames:

(add-hook 'after-make-frame-functions #'bufferlo-switch-to-scratch-buffer)

Alternatively, create a new local scratch buffer for new frames:

(add-hook 'after-make-frame-functions #'bufferlo-switch-to-local-scratch-buffer)

Of course, you can also set an arbitrary buffer as the initial frame buffer:

(defun my-set-initial-frame-buffer (frame)
  (with-selected-frame frame
    (switch-to-buffer "<BUFFER_NAME>")))
(add-hook 'after-make-frame-functions #'my-set-initial-frame-buffer)

"Bufferlo anywhere" lets you have bufferlo's frame/tab-local buffer list anywhere you like, i.e. in any command with interactive buffer selection (via read-buffer, e.g., diff-buffers, make-indirect-buffer, …) – not just in the switch-buffer facilities. You can configure which commands use bufferlo's local list and which use the global list.

Enable bufferlo-anywhere-mode to use bufferlo's local buffer list by default. Customize bufferlo-anywhere-filter and bufferlo-anywhere-filter-type to restrict the commands that use the local list. With the command prefix bufferlo-anywhere-disable-prefix, you can temporarily disable bufferlo-anywhere-mode for the next command.

Instead of the minor mode, you can use the command prefix bufferlo-anywhere-enable-prefix, which only temporarily enables bufferlo's local buffer list for the next command.