Workspace Plugin
Help query: "What does the workspace plugin do?" / "How do I switch workspaces?" / "How do I delete a workspace from the picker?"
The workspace plugin manages Volt workspaces: create/switch/delete/clone, open the worktree dashboard, list Git-visible files, search the project, save, format, window focus, and numbered marks.
| Package name | workspace |
| Module | user/workspace.rs |
What it does
- Create or focus a workspace from the project picker
- Switch among open workspaces and discovered projects (
workspace.switch) - Delete a workspace (dock, delete picker, or
Ctrl+din the switch picker) - Clone remotes into an oil directory; show checked-out worktrees
- List files visible to Git; search text across the active workspace
- Save buffers, format (preferring LSP when available), and move window focus
- Mark / unmark workspaces and jump to numbered mark slots
Commands
| Command | Description |
|---|---|
workspace.new | Creates or focuses a workspace from the project picker. |
workspace.switch | Switches to an open workspace or opens a discovered project. |
workspace.delete | Deletes the selected or focused workspace, or opens the delete picker. |
workspace.dashboard | Shows checked-out git worktrees for the active workspace. |
workspace.clone | Clones a remote repository (bare or full) into a chosen oil directory. |
workspace.list-files | Lists the current workspace files that are visible to Git. |
workspace.search | Searches text across files in the active workspace. |
workspace.save | Saves all modified file buffers in the active workspace. |
workspace.next | Switches to the next open Project Workspace in open order. |
workspace.previous | Switches to the previous open Project Workspace in open order. |
workspace.mark | Adds the active Project Workspace root to the Mark List. |
workspace.unmark | Removes the active Project Workspace root from the Mark List. |
workspace.marks | Opens the app-wide Mark List as an editable buffer. |
workspace.marked-1 … workspace.marked-4 | Jumps to Mark List slots 1–4. |
workspace.worktree-remove | Force-removes the selected Worktree from disk after closing matching Project Workspaces. |
workspace.format | Formats the active file buffer, preferring LSP formatting when available. |
workspace.window-left / down / up / right | Moves focus to the neighboring window (wraps). |
Keybindings
No package-level keybindings declared (may be bound from vim leader maps or YAML).
Picker extras on workspace.switch: Ctrl+d runs workspace.delete. See also Workspace Dock for dock j / k / Ctrl+d.
Notes
Many chords are provided by the vim leader map (Space w, Space p, window Ctrl+h/j/k/l, and similar). Project discovery roots live in user/config/workspace.yaml. Closing a workspace tears down Owned Processes tagged to that workspace (terminals, jobs, language tooling) via Process Launch / Process Registry.