This module adds support for workspaces, powered by persp-mode, as well as a API for manipulating them.
1.2. Module flags
This module has no flags.
1.4. TODO Hacks
This module has no external prerequisites.
There are many ways to use workspaces. I spawn a workspace per task. Say I’m working in the main workspace, when I realize there is a bug in another part of my project. I open a new workspace and deal with it in there. In the meantime, I need to check my email, so mu4e gets its own workspace.
Once I’ve completed the task, I close the workspace and return to main.
3.1. Isolated buffer-list
When persp-mode is active,
doom-buffer-list becomes workspace-restricted. You
can overcome this by using
3.2. Automatic workspaces
A workspace is automatically created (and switched to) when you:
- Create a new frame (with make-frame; bound to M-N by default).
- Switch to a project using
3.3. Session persistence
By default, your session is autosaved when you quit Emacs (or disable
persp-mode). You can load a previous session with
:sl[oad] (ex command).
You can supply either a name to load a specific session to replace your current one.
3.4. Workspace persistence
If you’d like to save a specific workspace, use
M-x +workspace/save, which can
be loaded into the current session (as another workspace) with
3.5. Commands & Keybindings
|Command||key / ex command||description|
||SPC TAB n||Create a new, blank workspace|
||SPC TAB TAB||Display open workspaces in the mode-line|
||SPC TAB l||Load a saved workspace into the current session|
||SPC TAB R||Restore last session|
||SPC TAB r||Rename the current workspace|
||SPC TAB s||Save the current workspace to a file|
||SPC TAB .||Switch to an open workspace|
||SPC TAB `||Switch to last workspace|
||SPC TAB [ / [ w / gT||Switch to previous workspace|
||SPC TAB ] / ] w / gt||Switch to next workspace|
||SPC TAB d||Delete the current workspace|
||SPC TAB x / :sclear||Clears the current session (kills all windows and buffers)|
4. TODO Configuration
This module has no configuration documentation yet. Write some?
There are no known problems with this module. Report one?
+workspace-buffer-list &optional PERSP-> bool
+workspace-p OBJ-> bool
+workspace-exists-p NAME-> bool
+workspace-get NAME &optional NOERROR-> Struct
+workspace-current &optional FRAME WINDOW-> Struct
+workspace-rename NAME NEW-NAME
+workspace-delete NAME &optional INHIBIT-KILL-P
+workspace-switch NAME &optional AUTO-CREATE-P
+workspace-protected-p NAME-> bool