> ## Documentation Index
> Fetch the complete documentation index at: https://panopticon-cli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# pan vault: back up and resume agent conversations across machines

> Session Vault commands: encrypted off-machine storage and cross-machine resume for agent conversations

`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](https://panopticon-cli.com/configuration/session-vault.md) 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

```bash theme={null}
pan vault setup <git-url>
```

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.

| Flag | Effect |
| - | - |
| `--hooks` | Also register the Claude Code Stop hook that saves after each turn. |
| `--passphrase-file <path>` | Also enable passphrase unlock with the passphrase in this file. |
| `--generate-passphrase` | Also enable passphrase unlock with a generated 6-word passphrase, printed once. |
| `--no-passphrase` | Do not offer passphrase unlock. |

`--passphrase-file` and `--generate-passphrase` cannot be combined.

## join

```bash theme={null}
pan vault join <git-url>
```

Join an existing vault from another machine with the vault passphrase or the recovery
phrase.

| Flag | Effect |
| - | - |
| `--phrase-file <path>` | Read the 24-word recovery phrase from a file instead of prompting. |
| `--passphrase-file <path>` | Read the vault passphrase from a file instead of prompting. |

`--phrase-file` and `--passphrase-file` cannot be combined.

## passphrase set

```bash theme={null}
pan vault passphrase set
```

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

| Flag | Effect |
| - | - |
| `--passphrase-file <path>` | Read the passphrase from a file instead of prompting. |
| `--generate` | Generate a 6-word passphrase and print it once. |

## passphrase remove

```bash theme={null}
pan vault passphrase remove
```

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

## rotate-key

```bash theme={null}
pan vault 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.

| Flag | Effect |
| - | - |
| `--yes` | Rotate without the confirmation prompt. |
| `--passphrase-file <path>` | Re-wrap passphrase unlock under the new key with the passphrase in this file. Also turns passphrase unlock on if it was off. |
| `--generate-passphrase` | Re-wrap passphrase unlock under the new key with a generated 6-word passphrase, printed once. Also turns passphrase unlock on if it was off. |
| `--no-passphrase` | Turn passphrase unlock off. |

Only one of `--passphrase-file`, `--generate-passphrase` and `--no-passphrase` may be given.

## status

```bash theme={null}
pan vault 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.

| Flag | Effect |
| - | - |
| `--json` | Output in JSON format. |

## save

```bash theme={null}
pan vault save [session-id-or-path]
```

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

| Flag | Effect |
| - | - |
| `--all` | Save every Claude Code transcript under `~/.claude/projects` and every Codex transcript under `~/.codex/sessions`. |
| `--since <date>` | With `--all`: only transcripts modified on or after this date. |
| `--harness <harness>` | With `--all`: only this harness, `claude-code` or `codex`. |
| `--hook` | Claude Code Stop-hook mode: read `{session_id, transcript_path}` JSON from stdin, print nothing, exit 0. |

## sync

```bash theme={null}
pan vault sync
```

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

## list

```bash theme={null}
pan vault list
```

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

| Flag | Effect |
| - | - |
| `--json` | Output in JSON format. |

## show

```bash theme={null}
pan vault show <id>
```

Print a saved conversation read-only with its versions.

| Flag | Effect |
| - | - |
| `--json` | Output in JSON format. |

## resume

```bash theme={null}
pan vault resume <id>
pan vault resume <id>@<version>
```

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

| Flag | Effect |
| - | - |
| `--cwd <dir>` | Working directory to resume in (default: the saved cwd). |
| `--no-launch` | Print the launch command instead of running it. |
| `--on-drift <choice>` | When the cwd state differs from the saved state: `continue \| note \| cancel`. |
| `--no-code` | Do not apply the saved code snapshot; only continue the conversation. |
| `--worktree <dir>` | Apply the code snapshot into a new git worktree at `<dir>` instead of the target checkout. |

## exclude

```bash theme={null}
pan vault exclude [path]
```

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.

| Flag | Effect |
| - | - |
| `--origin <url>` | Exclude conversations whose git origin is this URL. |
| `--session <id>` | Exclude one session by native session id or vault id. |

## include

```bash theme={null}
pan vault include [path]
```

Remove an exclusion added with `pan vault exclude`.

| Flag | Effect |
| - | - |
| `--origin <url>` | Include conversations whose git origin is this URL again. |
| `--session <id>` | Include one session again. |

## allow-secret

```bash theme={null}
pan vault allow-secret <id-or-path> [line]
```

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

| Flag | Effect |
| - | - |
| `--file <path>` | Allow the blocked lines of this file in the code snapshot (path relative to the repository root). |

## evict

```bash theme={null}
pan vault 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`.

| Flag | Effect |
| - | - |
| `--review` | Scan and print the batch with its fingerprint (default). |
| `--confirm <fingerprint>` | Delete the reviewed files if the batch still matches this fingerprint. |
| `--decline <vaultId>` | Remove an entry from the batch and do not offer it again. |
| `--reoffer <vaultId>` | Allow a declined entry to be offered again. |
| `--clear` | Empty the batch without deleting or declining anything. |

## restore

```bash theme={null}
pan vault restore <id>
```

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

| Flag | Effect |
| - | - |
| `--to <path>` | Write the rebuilt file here instead of the recorded 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](https://panopticon-cli.com/configuration/session-vault.md#from-the-dashboard).

## 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](https://discord.gg/ZpHE2ZTv5P) or file a
[GitHub Issue](https://github.com/eltmon/overdeck/issues).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.