Codex Relay

A tiny workflow for handing off Codex-assisted development between two devices through GitHub.

It is for people who want to:

• code on a PC at home;
• continue later on a MacBook;
• avoid keeping both machines online;
• avoid relying on Codex chat memory;
• keep each project cleanly synced through its own GitHub repository.

Read the full guide: CODEX_RELAY.md

30-second version

# start
git status
git pull --rebase

# pause / hand off
git add .
git commit -m "wip: hand off current task"
git push

# resume on another device
git pull --rebase
cat HANDOFF.md

Ask Codex to set it up

Read CODEX_RELAY.md and help me set up the same Codex Relay workflow for my devices and GitHub account.

For a new project:

Create a new private GitHub repository for this project under YOUR_USERNAME. Initialize Git if needed, add README.md and HANDOFF.md, make the first commit, push to origin/main, and report the repo URL.

Files

• CODEX_RELAY.md: complete workflow
• HANDOFF.md: copy this into each project that needs device handoff
• LICENSE: MIT

License

MIT