--tool <codex|claude> |
all |
Which agent to act on. Default: auto-detect when possible. On import, the bundle's recorded tool wins. |
--codex-home <path> |
all |
Use a specific Codex home instead of the default. Also honors $CODEX_HOME. |
--claude-home <path> |
all |
Use a specific Claude Code home instead of ~/.claude. Also honors $CLAUDE_HOME. |
--project <path> |
export, import |
Export: filter sessions by recorded cwd. Import: warn on cwd mismatch. |
--all |
export |
Export every session regardless of cwd. Mutually exclusive with --project. |
--session <id> |
export, import |
Export exactly one session by thread id prefix. Import only matching sessions. Repeatable on import. |
--since <when> |
export |
Only sessions updated at or after a date (YYYY-MM-DD) or duration (7d, 48h, 90m). |
--with-git |
export |
Record the project's git remote, branch, commit, and dirty/unpushed status. |
--git-push |
export |
Opt-in. Push the current branch to its own remote first so the recorded commit is fetchable. Never force-pushes. |
--strip-images |
export |
Replace inline base64 images with placeholders to shrink the bundle. Lossy; needs zstd for .jsonl.zst. |
--output, -o <path> |
export |
Bundle output path. Defaults are derived from --project, --all, or --session. |
--include-archived |
list, export |
Include archived sessions. |
--json |
doctor, list, inspect, export, import, sync |
Print machine-readable JSON instead of text. |
--dry-run |
import, sync |
Validate and report only; write nothing. |
--to <codex|claude> |
import |
Cross-agent handoff: translate bundle sessions into the other agent's format. |
--regex / --case-sensitive |
search, export |
Treat the query (search or export --match) as regex / match case-sensitively. |
--match <query> |
export |
Bundle only sessions whose conversation text matches the query. |
--format md|html |
export |
Render selected sessions as readable Markdown or self-contained HTML instead of a re-importable bundle. |
--redact |
export, sync |
Replace likely secrets with placeholders. Lossy and opt-in. |
--allow-secrets |
export, sync |
Proceed even though a likely secret was detected. |
--run |
resume |
Launch the agent on the chosen session now. |
--remember |
sync |
After code pairing, remember the peer so later syncs can skip the code. |
--interval <n> / --once |
sync daemon |
Poll every <n> seconds (default 5), or run one discover-and-sync sweep and exit. |
--map-cwd OLD=NEW |
import, sync |
Rewrite matching sessions' recorded cwd. Plain .jsonl always; .jsonl.zst when zstd is installed. Repeatable. |
--map-cwd-here |
import, sync |
Map the bundle's project to the current directory. Single-project only; cannot combine with --map-cwd. |
--merge |
import |
Incremental sync. If the local session is a prefix of the bundle's, append only the new messages. The comparison is serialization-tolerant: records that differ only in JSON key order or escaping (as after a cross-platform transfer) count as equal, and the local file's own serialization is preserved. |
--replace-with-backup |
import |
On conflict, back up the local file and overwrite it with the bundle's version. |
--import-as-copy |
import |
On conflict, import the bundle's version as a new session, leaving yours untouched. Excludes --replace-with-backup. |
--clone <dir> |
import |
After importing, clone the bundle's recorded git remote into <dir> and check out its commit. |
--encrypt-to <recipient> |
export |
Encrypt to an age recipient (age1... or ssh-ed25519 ...). Repeatable. Writes <output>.age. |
--recipients-file <file> |
export |
Encrypt to every age recipient listed in <file>. |
--passphrase |
export, import, inspect |
Export with a passphrase, or decrypt a passphrase-encrypted bundle. |
--identity <file> |
import, inspect |
age identity/private key file used to decrypt a .age bundle. |