A space is an independent timeline of snapshots within one workspace. It is the closest Rinne equivalent to a branch-like line of history.
Each space has its own history. Switching spaces changes the active timeline but does not rewrite or merge other spaces.
Usage
rinne space list
rinne space create <name>
rinne space use <name>
rinne space rename <old> <new>
rinne space current
rinne space delete <name>
Commands
list
Show all existing spaces.
create <name>
Create a new empty space. Fails if the name already exists.
use <name>
Switch the active space by updating .rinne/snapshots/current.
rename <old> <new>
Rename a space and update manifest.db metadata. Cannot overwrite another space and does not allow case-only renames.
current
Print the currently active space.
delete <name>
Delete a space only if it has no snapshots and no manifest.db history, and only when it is not the current space.
Examples
List all spaces
rinne space list Create a new space
rinne space create experiment Switch to another space
rinne space use experiment Show the active space
rinne space current Rename a space
rinne space rename prototype main
Notes
- Deleting a space is intentionally conservative. It fails when data still exists in that space.
- Renaming updates both the snapshots directory and ManifestDB metadata for safety.