Moving to a new Mac
New hardware.
Same unfinished work.
A development workspace is more than a GitHub clone. It includes the conversation you want to resume, the branch you have not pushed, and the custom skill your project depends on.
Codex Migrate is an independent, open-source tool for moving local Codex workspaces between Macs over SSH. The engine is available as an alpha CLI. A $50 one-time Mac app is in development; no preorders are being taken.
Select the work, not just the repository
The migration includes active and archived local conversations, configuration, project organization, skills, rules, memories, automations, and relevant Codex state. You explicitly select the workspace folders to copy.
Inside those selected roots, the copy includes Git history, local branches, tags, stashes, linked-worktree metadata, and uncommitted or untracked files. Repositories or worktree directories outside those roots are not automatically included. Inspect the plan and include every location you still need.
Keep the new Mac’s login
Install Codex and sign in on the new Mac first. Codex Migrate preserves that machine’s authentication and installation identity. It does not copy the old Mac’s Codex login or SSH private-key directory. Credentials embedded in selected workspace files are still part of those files—review your selections carefully.
Transfer, pause, resume
Enable Remote Login for the destination user, verify the SSH host fingerprint, and inspect both Macs before enabling changes. Staging is resumable: after an interruption, rerun with the same destination and scope to reuse completed data. Wi-Fi, Ethernet, and working Thunderbolt networking can all carry SSH; plugging in a USB-C cable alone does not establish a network connection.
Verify before you retire the old Mac
Final installation requires Codex closed on both Macs and a verified destination backup. If the usernames differ, old absolute paths may need a reviewed compatibility alias. Open important conversations, check custom skills, and inspect your repositories on the new machine. Do not erase the old Mac just because a progress bar reached 100%.
The source Mac is left intact. Backups and verification reduce risk; they do not replace an independent backup or guarantee compatibility with every Codex version.