Your repository
Encrypted files go directly to your chosen private GitHub repository; Madu does not operate an additional relay server. You can revoke its token at any time.
v0.5.0Private GitHub sync
Continue your Codex tasks and skillson another computer.
Madu (Codex to Codex) encrypts and syncs Codex tasks and skills between Windows and macOS. Data goes only to your private GitHub repository, and every transfer is initiated by you.
AES-256-GCMYour private repositoryEvery transfer is manual
PRIVATE ROUTE · v0.5.0
THIS COMPUTERWindows
NEXT COMPUTERmacOS
•••ENCRYPTED
YOUR PRIVATE REPO
Move your cursor to trace the crossing
WHY MADU
Your workflow stays yours.Only the context crosses.
Every crossing is manual
Nothing uploads in the background. You initiate every download, selection, and upload.
Tasks and skills travel together
Tasks include messages, replies, and plans. Skills include SKILL.md, scripts, assets, and references, while common credentials and caches are blocked.
THE SAFE PROTOCOL
Download first.
Then upload.
This is an enforced conflict check, not a reminder you can skip.
PULL
Download remote
Read encrypted remote tasks and skills and record the current Git commit.
SELECT
Select local content
Only the tasks or skills you select are encrypted and uploaded.
VERIFY & PUSH
Verify and upload
If the remote changes after your download, Madu blocks the upload and asks you to download again.
DESKTOP CLIENT
Tasks and skills in one crossing.
Tasks, skills, repository setup, and the guide each have a clear destination. Skill files are verified before installation and existing versions are backed up before replacement.
256BIT
GCM
GCM
ENCRYPTED BEFORE UPLOAD
Task and skill plaintext is not written to GitHub.
Tasks and skills are encrypted with AES-256-GCM before leaving your computer and stored as .c2c files. Skill installation verifies SHA-256 hashes, blocks path traversal, and backs up existing versions. The operating system protects both the sync password and GitHub token.
- Windows token
- DPAPI
- macOS token
- Keychain
- Required permission
- Contents: Read & write
- Upload mode
- Manual
CROSSING RECORDS
Clear answers before you cross.
These answers describe how the current version actually works, so you can decide whether Madu fits your Codex workflow.
01What is Madu?
Madu is a tool for syncing Codex conversations across computers. It encrypts selected conversations locally, stores them in your private GitHub repository, and lets you download and import them on another computer.
02What Codex data does Madu sync?
The current version syncs user messages, assistant replies, and historical plans. Madu does not separately package tool logs, local credential stores, or project files. However, tokens, passwords, or other secrets already present in selected conversation messages will still be transferred.
03Which skill files are transferred?
Madu scans .codex/skills and .agents/skills and transfers SKILL.md, scripts, assets, and references. System skills, plugin caches, node_modules, virtual environments, and common credential files are not copied.
04Where is my data stored?
Encrypted conversations are stored as .c2c files directly in the private GitHub repository you choose. Madu does not operate an additional relay server.
05Can GitHub read my conversations?
Conversation content is encrypted with AES-256-GCM before leaving your computer. GitHub can see the .c2c files and commit metadata, but without the correct sync password it cannot read remote conversation titles or plaintext content.
06Does Madu sync automatically?
No. Madu does not upload in the background. You initiate every download, conversation selection, and upload.
07How does Madu prevent one computer from overwriting another?
Before every upload, Madu requires a remote download and records the current Git commit. If the repository changes before upload, Madu blocks the write and asks you to download again.
08What GitHub permissions does Madu need?
The repository must be initialized and private, and the token needs Contents: Read and write permission. For least privilege, use a fine-grained Personal Access Token limited to that repository.
09Are the sync password and GitHub token stored?
They are encrypted on the current computer with Electron safeStorage, using DPAPI on Windows and Keychain on macOS. Clearing the sync password field also deletes the remembered sync password.
10Which operating systems are supported?
Madu provides a Windows x64 installer and universal macOS 12+ DMG and ZIP packages for Apple Silicon and Intel. The current macOS packages are not Apple Developer ID signed or notarized.
11Do I need to restart Codex after importing a conversation?
No. An imported conversation can open directly in the running Codex app.
12Is Madu an official OpenAI tool?
No. Madu is an independent third-party tool. It is not an official OpenAI product and is not endorsed by OpenAI. Codex is an OpenAI product name.
THE NAME OF THE CROSSING
Why “Madu”?
I imagine every Codex conversation as a small boat carrying a train of thought.
CODE · CONTEXT
“Ma” points to code—and the context we build with AI.
CROSSING · CONTINUE
“Du” means crossing: carrying unfinished ideas safely from one computer to another, so the work can continue.
Your data stays in your repository and every transfer starts with you; Madu only carries the selected working context to another computer.
ABOUT THE MAKER
About me
I’m Lutu AI (鹿先森), a practitioner focused on putting AI into real daily work. I study Codex, automation workflows, and practical AI tools—and share both the pitfalls and the methods worth reusing.
“A tool proves its value not in a demo, but when it reliably carries the next piece of real work.”
Codex workflowsPractical AI toolsAutomation methods
WeChat Official AccountWECHAT
Scan with WeChat for Codex workflows, practical AI tools, and field notes.
START CROSSING
Start from this computer.
Current version v0.5.0. Windows x64 and universal macOS 12+ packages are now available from the public GitHub Release. The current macOS packages are not signed or notarized.
WINDOWS · X64Codex-to-Codex-0.5.0-Setup.exeDownload the Windows x64 installer from GitHub Releases
Download for Windows
MACOS 12+ · UNIVERSALCodex-to-Codex-0.5.0-macOS-universal.dmgFor macOS 12 or later, compatible with Apple Silicon and Intel
Download for macOS
FULL GUIDERead the detailed user guide
Open Feishu doc ↗
Follow the complete path from GitHub token setup to your first cross-computer sync.