In Diversion, you can shelve your current work and apply it later when switching back to the original branch. This works similarly to the “stash” mechanism in Git.Documentation Index
Fetch the complete documentation index at: https://docs.diversion.dev/llms.txt
Use this file to discover all available pages before exploring further.
When to use shelves
- Switching context: Save work-in-progress before switching to another branch
- Experimenting: Try out changes without committing, easily revert if the experiment doesn’t work
Creating a shelf
Use the shelf button in your workspace to create a shelf.- Select the files you want to shelve in your workspace
- Click Shelve… to open the naming dialog:
- Name your shelf
- Click Create shelf
Automatic shelves
When switching branches with uncommitted changes, a popup menu will ask what to do with them.
Naming your shelf
When creating a shelf, you can:- Enter a custom name (max 60 characters)
- Click Generate name
to create a name like my_branch (2025-01-13 13:00:00)
Shelf names must be unique within your repository.
Managing shelves
Open the shelves menu from the workspace drop-down to view and manage your shelves.
Preview
Click on a shelf to preview its contents before applying.Apply
Click Apply to restore the shelved changes to your workspace.Rename
Click Rename to change the shelf name.Delete
Click Delete to permanently remove a shelf. This action cannot be undone.For CLI usage, see the shelf command reference.