ui/workspaces: replace `persp-mode` with `tabspaces`

[hlissner]

Important

This is a roadmap issue and is used solely to announce and document progress (to make it easier for users to follow and maintainers to track). Please do not use it for discussion; use our discussion board instead.

Note

This is being worked on in the feature/tabspaces branch.

persp-mode is notoriously difficult to work with. Documentation is light, breaking changes have wide-reaching effects, and the project reinvents a few wheels (desktop.el, tab-bar, etc). Replacing it is complicated, because so many packages and modules are integrated into it. The :ui workspaces module tries to provide:

• Isolated, per-workspace buffer lists
• Session persistence
• Saved, switchable, and nameable window configurations
• A UI for workspaces (e.g. tabs)
• Integration with project.el/projectile (e.g. project workspaces)

The packages I'm currently considering to replace persp-mode with are (ordered by most to least promising):

• https://github.com/mclear-tools/tabspaces
• https://github.com/jamescherti/easysession.el
• https://github.com/j-hotlink/hotdesk
• https://github.com/alphapapa/activities.el
• https://github.com/wasamasa/eyebrowse
• Native: tab-{bar,line}-mode (built in to 27+) + desktop.el

Tasks

• Replace persp-mode config with tabspaces?
• Command remappings for persp-switch-to-buffer (in :completion modules)
• Add session persistence (e.g. https://github.com/jamescherti/easysession.el or desktop.el)
• Fix package integrations
  • better-jumper
  • treemacs (already has integrations for persp-mode, perspective.el, and tab-bar)
• Update keybinds
  • +evil-bindings.el
  • +emacs-bindings.el
  • modules/editor/evil/config.el (gt, gT, [w, ]w)
  • modules/input/layout/+azerty.el
• Resolve references to old persp-mode API
  • :term toggle commands: +term/toggle, +eshell/toggle, +shell/toggle, +vterm/toggle
  • +irc--add-circe-buffer-to-persp-h
  • +ibuffer/visit-workspace-buffer
  • +doom-dashboard-menu-sections
  • +doom-dashboard-reload
  • +doom-dashboard-init-h
  • +doom-dashboard--persp-record-project-h
  • +doom-dashboard--persp-detect-project-h
  • doom-session-file
  • doom-save-session
  • doom-load-session
  • +org-exclude-agenda-buffers-from-workspace-h
  • +vertico--workspace-buffer-state
  • +eshell-switch-workspace-fn
  • +eshell-save-workspace-fn
  • +ibuffer-workspace
  • +ibuffer/open-for-current-workspace
  • +ibuffer/visit-workspace-buffer
  • +ivy--is-workspace-buffer-p
  • +ivy--is-workspace-other-buffer-p
  • =mu4e
  • +mu4e-kill-mu4e-h
  • (define-ibuffer-filter workspace-buffers ...)
  • =notmuch
  • +notmuch/quit
  • +vertico--workspace-buffer-state
  • +vertico--workspace-generate-sources
  • +vertico/switch-workspace-buffer
  • +vertico/embark-open-in-new-workspace
  • =rss
  • +rss-cleanup-h
  • +julia--namespace-repl-buffer-to-workspace-a
  • +evil:kill-all-buffers
• Merge into master

[hlissner]

I've started work on this in the experimental feature/tabspaces branch. I can't guarantee tabspaces is what we'll stick with, but so far it seems the most promising.

[doom-bot]

[doomemacs:feature/tabspaces] 4 new commits

• 243b258 refactor!(workspaces): replace persp-mode w/ ta... - hlissner
• eb7cb5e fix(modeline): don't show tabspaces name in mod... - hlissner
• ba94082 fix(default): update workspaces keybinds - hlissner
• c5ce42f fix(doom-dashboard): replace persp-mode w/ tabs... - hlissner

[doom-bot]

[doomemacs:feature/tabspaces] 4 new commits

• f40bbad fix(workspaces): evil ex commands - hlissner
• 64ab02e fix(workspaces): vim keybinds & ex commands for... - hlissner
• a2f4655 fix(workspaces): leader keybinds - hlissner
• 251195e fix(workspaces): +workspaces/kill: safeguards - hlissner

[doom-bot]

[doomemacs:feature/tabspaces] 8 new commits

• 643941b fix(layout): update workspaces keybinds - hlissner
• 1592b07 fix(:completion): update for tabspaces - hlissner
• 76a7ccf fix(evil): +evil:kill-all-buffers: update for t... - hlissner
• 704bf43 fix(workspaces): close-window-or-workspace remaps - hlissner
• 9c3d762 feat(workspaces): introduce +tabs flag - hlissner
• 80c220a feat(doom): tab-bar: add basic theming - hlissner
• 59a13c3 feat(default): bind 'SPC TAB b' to tabspa... - hlissner
• c2a53f8 fix(workspaces): remove +workspaces--e... -hlissner

[doom-bot]

[doomemacs:feature/tabspaces] 7 new commits

• c117897 feat(workspaces): expand and polish API - hlissner
• b7d0c20 feat(workspaces): introduce +workspaces-dir - hlissner
• beed114 fix(ibuffer): update for tabspaces - hlissner
• 8ce1c81 fix(irc): update for tabspaces - hlissner
• 7a08b7c fix(:term): update for tabspaces - hlissner
• 1f9c0d6 fix(org): update for tabspaces - hlissner
• 697441c fix(lib): update for tabspaces - hlissner

[doom-bot]

[doomemacs:feature/tabspaces] 4 new commits

• 10615a2 fix(nav-flash): update for tabspaces - hlissner
• 4b69b2a fix(workspaces): +workspaces-buffer-list: inclu... - hlissner
• 7baa364 tweak(workspaces): +workspaces-remove-buffer-fr... - hlissner
• 6209366 fix(workspaces): +workspaces/kill - hlissner

[doom-bot]

[doomemacs:feature/tabspaces] 5 new commits

• 407eae5 bump: :ui workspaces - hlissner
• c75f404 fix(tabs): update for tabspaces - hlissner
• c626454 fix(everywhere): update for tabspaces - hlissner
• bce3aff fix: more vestigial references to persp-mode - hlissner
• 5072c96 fix(dired): remove unneeded persp-mode hack - hlissner

[doom-bot]

[doomemacs:feature/tabspaces] 7 new commits

• 065b952 tweak(workspaces): centralize project session f... - hlissner
• c57f2df fix(workspaces): projectile/project integration - hlissner
• 4e1b3cd tweak(workspaces): tabspaces-fully-resolve-path... - hlissner
• a307383 fix(workspaces): unbalances parens - hlissner
• 5388480 tweak: default values for tab-*-tab-choice vars - hlissner
• 96a1b72 fix(workspaces): missing tabspaces-session-file parent dir - hlissner
• a88cb71 feat(workspaces): implement tab-local parameters - hlissner