Codex

Pack your Codex workspace or bring work from another agent into Codex. Install Desk and the target agent before moving.

Pack Codex work

Stop Codex and other project writers, then run:

cd /path/to/project
desk pack --from=codex
desk ls

To 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 config.toml, AGENTS.md, skills, rules, and project session files. Ordinary capture uses CODEX_HOME when set, otherwise ~/.codex. Local moves use that same native configuration directory.

Move to Codex

For example, start with a Claude project. Stop its writers and run:

cd /path/to/claude-project
desk pack --from=claude
desk move --to=codex

Without 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=codex.

Desk restores the conversation into your local Codex session directory and resumes it using your existing configuration and login. Local moves keep the project directory. Native settings are archived for review; Desk does not automatically convert another agent’s permissions, hooks, or authentication.

Resume your moved Codex session

After exiting Codex, return to the printed Workspace using your normal shell. Desk uses your existing HOME, configuration and login.

cd /path/printed/as/Workspace
codex resume --last

codex resume --last continues the latest saved session for this directory. Use codex resume from that directory to open the session picker. See the Codex CLI documentation.

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

Once the resumed agent has stopped, run these commands from your normal shell:

cd /path/printed/as/Workspace
desk pack --from=codex
desk move --to=claude

Desk 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.