CLI Overview

Rinne CLI is a command-line tool for working with a Rinne workspace. Create and manage snapshots, attach notes, compare changes, verify integrity, restore past states, prepare repair data, review command activity, and operate multiple timelines with spaces.

The CLI keeps the model simple: each command does one job, and you decide how to connect them. Use it directly in a terminal, or wire it into scripts, schedules, and tests.

Use save to create history,diff to inspect changes,restore orextract to recover content, and verify,validate,gc, andrepair for maintenance.

v0.9.7 adds activity, a separate local history of CLI command execution. It records results, exit codes, timing, and bounded error details in.rinne/activity/activity.db when recording is enabled.

Activity history

Activity history is independent from snapshot history. Snapshot history describes saved workspace states; Activity describes CLI commands that were executed in the workspace.

Recording is disabled by default and is controlled by .rinne/activity/settings.json.
Entries use UUIDv7 identifiers and a BLAKE3 hash chain.
rinne activity list and show review entries; verify checks chain consistency.
prune applies retention limits; clear --force starts a new Activity epoch.
Activity write failures use best-effort handling and do not change the main command result.

See the activity command referencefor selectors, date filtering, settings, pruning, and verification behavior.

Command groups

Workspace

init, config, version

Snapshots

save, autosave, history, delete

Compare

diff, diff-file, diff-text

Recovery

extract, restore, fuse, repair

Integrity

verify, validate, gc

Organization

space, note, autonote

Execution history

activity

Early Access note: flags and output formatting may evolve between versions. Use the unified exit codes for scripting.