cairn

commands

What each command does

Add --json anywhere when a program needs to parse the output.

commandwhat it does
storeSave a fact. An exact copy is ignored. A near copy is reported.
retrieveSearch by meaning. Filter with --task when you have one.
list / getLook up by task, keyword (--search), or one key.
archive / restoreTake a fact down, or put it back. Restore retires the version that replaced it.
purgeDelete a fact for good. You must pass --force.
gcShow what cleanup would remove. --apply does the removal.
ingestRead a docs directory and store one memory per section.
export / importWrite or read a pack of memories. Import adds missing keys. It does not fight over the same key.
serve / push / pullSync over HTTP with a bearer token. This stays a terminal command.
backup statusShow the last successful backup for each configured destination.
backup replicateRun continuous SQLite backup replication to configured local folders or S3-compatible buckets.
restore --from <target> [--at <timestamp>]Restore a SQLite vault from a backup. --at selects the latest retained update at or before a timezone-aware timestamp.
embeddRun one shared embedding process for this machine. This is not the sync server.
galaxyOpen a local page that draws the vault. Default port 8780.
init / bootstrapCreate the vault, then wire the project files.
whoami / doctor / logShow identity, check the vault, or read the audit log.

For destination setup and restore requirements, see the SQLite backup and restore guide.