save is the main checkpoint command. It records the current state into the active space, writes the snapshot metadata, and stores file content through the current ManifestDB + CAS pipeline.
Scoped save is supported. Use --dir and --file to rebuild only part of the next snapshot, optionally from a specific base snapshot.
Usage
rinne save [--full] [--parallel <N>] [--space <space>] [--dir <path>]... [--file <path>]... [--base <snapshot>] [-m <message> | --message <message>]
Options
--full
Create a CAS snapshot by fully reprocessing all files, ignoring any existing file meta cache.
--parallel <N>
Override the default parallelism for file processing.
--space <space>
Save into the specified space instead of the current space.
--dir <path>
Scoped save. Scan only the specified workspace-relative directory subtree and replace that subtree in the new snapshot. Can be specified multiple times.
--file <path>
Scoped save. Scan only the specified workspace-relative file and upsert that file in the new snapshot. Can be specified multiple times.
--base <snapshot>
Base snapshot for scoped save. Accepts a full snapshot id, an id prefix, or @N. If omitted for scoped save, the latest snapshot in the target space is used.
-m, --message <message>
Write a note to <id>/note.md. If omitted, an empty note.md is created.
Examples
Create a normal snapshot in the current space
rinne save Create a snapshot with a note
rinne save -m "Before upgrading dependencies" Force full reprocessing
rinne save --full -m "Rebuild baseline" Update one subtree in the next snapshot (uses latest snapshot as base by default)
rinne save --dir Assets/ Update selected files in the next snapshot (uses latest snapshot as base by default)
rinne save --file src/main.cs --file README.md Scoped save using an explicit base snapshot
rinne save --dir Assets/Textures --base '@1' -m "Texture update" Save into another space
rinne save --space experiment -m "Try alternative branch"
Notes
- save records the current workspace state into the active space.
- For scoped save, paths are workspace-relative.
- If --base is omitted during scoped save, the latest snapshot in the target space is used automatically.