desk pack

Save a source workspace, supported native settings and project sessions as a tar snapshot. The command prints the pack ID and archive path and records the source as packed in desk ps.

desk pack [flags]

Examples

# Detect the source agent in the current directory.
desk pack

# Choose a source and conversation.
desk pack --from=claude
desk pack --from=claude --session=SESSION_ID

# Capture a specific project and source HOME.
desk pack --from=bob --project=/path/to/project --source-home=/path/to/home

Stop the source agent and other project writers first. Packing creates no target workspace, HOME, or handoff task and requires no installed agent executable.

Flags

Flag	Meaning
--from	Source: claude, codex, qoder, or bob. Auto-detected when unambiguous.
--project	Source workspace. Defaults to the current directory.
--source-home	Source agent HOME. Defaults to the user HOME, or the managed workspace’s HOME.
--session	Selected conversation. Defaults to the newest parent session.

For ordinary Codex capture, Desk honors CODEX_HOME when --source-home is not provided. Source detection also recognizes an existing Desk working workspace, including when the current directory is nested inside it.

Packs are stored in ~/.desk/store/packs/ by default, or $DESK_HOME/store/packs/ when DESK_HOME is set.

Use the saved pack

desk ls
desk move PACK_ID --to=codex

Every pack gets a new ID. Every move from a pack restores a separate writable copy. See storage and archives for contents and file handling.