Skip to main content
pan vault saves your agents’ conversations, encrypted, into a backend you own, and lets another machine pick a conversation up where it left off. Released in v0.64.0. See Session Vault for the full guide. pan vault sends no telemetry. With no backend configured, every verb except setup and join prints Session Vault is off. Run: pan vault setup <git-url>.

setup

Enable the vault against your own git remote and print the recovery phrase once. <git-url> may also be dir:<path> for a local directory or NAS mount. --passphrase-file and --generate-passphrase cannot be combined.

join

Join an existing vault from another machine with the vault passphrase or the recovery phrase. --phrase-file and --passphrase-file cannot be combined.

passphrase set

Wrap the vault key under a passphrase so a new machine can join without the recovery phrase.

passphrase remove

Delete the passphrase unlock object; joining then needs the recovery phrase. Takes no flags.

rotate-key

Replace the vault key after losing a device: re-encrypt refs under a new key, keep old chunks readable, print a new recovery phrase. Only one of --passphrase-file, --generate-passphrase and --no-passphrase may be given.

status

Show the backend, when the key was last rotated, this machine, owned and listed records, last sync, whether eviction is on, and the machine list.

save

Settle one transcript (by session id or path) or many into the vault.

sync

Settle owned transcripts that grew, register this machine and refresh the list. Takes no flags.

list

List saved conversations from the local cache. Never contacts the backend.

show

Print a saved conversation read-only with its versions.

resume

Continue a saved conversation here; adopts it and launches the harness. <id>@<version> forks at that version instead of the latest.

exclude

Exclude conversations by cwd path, git origin or session id. With --session, the conversation’s saved record becomes a tombstone; a path or origin exclusion stops future saves only.

include

Remove an exclusion added with pan vault exclude.

allow-secret

Allow one blocked transcript line, or the blocked code lines of one file, for that record only.

evict

Review the pending-deletion batch (default) or act on it. Nothing is deleted without --confirm. Eviction needs "evict": true in ~/.overdeck/vault/config.json.

restore

Rebuild an evicted transcript byte for byte at its original path.

In the dashboard

Settings → Session Vault sets up, joins and unlocks a vault, runs Sync now, lists the machines and reviews transcripts waiting for deletion. A conversation’s ⋮ menu has Continue on another device, and a read-only copy from another machine has Continue here. See Session Vault.

Get help

Session Vault is off. Run: pan vault setup <git-url> means no vault is configured yet. Session Vault backend is set to <backend> but the key file is missing. Run: pan vault join <backend> means this machine never joined, or lost its key file. Still stuck? Ask on the Overdeck Discord or file a GitHub Issue.