Claude
Pack your Claude workspace or bring work from another agent into Claude. Install Desk and the target agent before moving.
Pack Claude work
Section titled “Pack Claude work”Stop Claude and other project writers, then run:
cd /path/to/projectdesk pack --from=claudedesk lsTo select a particular source conversation, add --session=SESSION_ID.
Desk records the source directory in the pack metadata. Your source files stay in place.
Desk captures supported settings and project sessions from ~/.claude: settings.json, CLAUDE.md, skills, commands, and agents, plus project conversation files and associated history.
Move to Claude
Section titled “Move to Claude”For example, start with a Codex project. Stop its writers and run:
cd /path/to/codex-projectdesk pack --from=codexdesk move --to=claudeWithout an ID, Desk uses the newest saved pack for that directory. To select a
pack explicitly from any directory, use desk move PACK_ID --to=claude.
Desk keeps the original project directory when it matches the pack’s source path;
an explicit pack moved from another directory uses an extracted workspace.
Desk writes extracted user and assistant text to the native
HOME/.claude/projects/PROJECT_KEY/SESSION_ID.jsonl location, with linked message
IDs and the target workspace path, then launches claude --resume SESSION_ID.
The restored conversation appears directly in Claude. Tool calls, reasoning,
permissions, and authentication are not imported.
Desk prints the workspace and uses your normal HOME and existing login. Native settings are archived for review; Desk does not automatically convert another agent’s permissions, hooks, or authentication.
Resume your moved Claude session
Section titled “Resume your moved Claude session”After exiting Claude, return to the printed Workspace using your normal shell. Desk uses your existing HOME, configuration and login.
cd /path/printed/as/Workspaceclaude -cclaude -c continues the most recent conversation in the moved directory. To choose a conversation, use claude --resume from that directory. See the Claude CLI reference.
Use the same executable as the original move if you supplied --binary.
The moved agent must have saved a session to resume.
Direct native launches do not update the earlier Desk record in desk ps.
Pack new progress and move again
Section titled “Pack new progress and move again”Once the resumed agent has stopped, run these commands from your normal shell:
cd /path/printed/as/Workspacedesk pack --from=claudedesk move --to=codexDesk recognizes the moved workspace and captures its local native session, including earlier handoff context. Moving uses the new pack for this directory. Choose a different target from the source agent; same-agent moves are currently unsupported.
See the harness support matrix for supported directions.