v0.5.0GitHub 私有仓库同步

让 Codex 任务和技能,换台电脑继续。

码渡(Madu · Codex to Codex)可以在 Windows 与 macOS 之间加密同步 Codex 任务和技能。数据只进入你自己的 GitHub 私有仓库;同步不会在后台自动发生,每一步都由你发起。

AES-256-GCM自己的私有仓库全程手动确认

为什么用码渡

不接管你的工作流,只帮对话安全过河。

01

仓库属于你

加密文件直接保存到你指定的 GitHub 私有仓库;码渡不运营额外的中转服务器。你也可以随时撤销 Token。

02

每次手动确认

没有后台自动上传。下载、选择、上传,每一步都由你发起。

03

任务和技能一起接力

任务同步用户消息、助手回复与历史计划;技能同步 SKILL.md、脚本、素材和参考文件,并拦截常见凭据与缓存目录。

安全同步顺序

上传之前,
必须先下载。

这不是一句提醒,而是一道不能跳过的冲突保护。

1
PULL

下载远程

读取远程加密任务和技能,并记录当前 Git commit。

2
SELECT

选择本机内容

只有你勾选的任务或技能才会被加密和上传。

3
VERIFY & PUSH

核对后上传

远程若出现新提交,码渡会拒绝覆盖并要求重新下载。

桌面客户端

任务与技能,一处同步。

任务、技能、仓库设置和使用指南都有清晰入口。技能安装前逐文件校验,覆盖同名技能前自动备份旧版本。

256BIT
GCM

本机加密后上传

任务和技能明文不会写入 GitHub。

任务与技能在离开电脑前完成 AES-256-GCM 加密,GitHub 保存的是 .c2c 加密文件。技能安装还会校验 SHA-256、阻止路径越界,并在覆盖前备份旧版本。同步密码与 GitHub Token 都由操作系统安全存储加密保护。

Windows Token
DPAPI
macOS Token
Keychain
所需仓库权限
Contents: Read & write
上传方式
手动发起

渡送档案

关于码渡,先说清楚。

这些答案来自当前版本的真实工作方式,方便你判断码渡是否适合自己的 Codex 工作流。

12项关键说明FAQ INDEX · v0.5.0

01码渡是什么?

码渡是一款 Codex 对话跨电脑同步工具。它在本机加密你选中的对话,再通过你自己的 GitHub 私有仓库,将对话下载并导入另一台电脑。

02码渡会同步哪些内容?

当前版本同步用户消息、助手回复和历史计划。码渡不会另行打包工具日志、本机凭据库或项目文件;但如果 Token、密码等敏感信息已经出现在所选对话的消息文本中,它仍会随对话同步。

03技能同步会带走哪些文件?

码渡扫描 .codex/skills 和 .agents/skills,同步技能目录中的 SKILL.md、脚本、素材和参考文件。系统技能、插件缓存、node_modules、虚拟环境和常见凭据文件不会复制。

04数据保存在哪里?

加密后的对话以 .c2c 文件直接保存到你指定的 GitHub 私有仓库;码渡不运营额外的中转服务器。

05GitHub 能看到对话内容吗?

对话内容在离开电脑前使用 AES-256-GCM 加密。GitHub 会看到 .c2c 文件和提交元数据,但没有正确的同步密码,无法读取远程对话的标题和明文内容。

06码渡会自动上传吗?

不会。码渡没有后台自动上传;下载、选择和上传都需要由你主动操作。

07如何避免两台电脑互相覆盖?

每次上传前必须先下载远程内容并记录当前 Git commit。若上传前远程仓库发生变化,码渡会阻止上传并要求重新下载。

08GitHub 需要什么权限?

仓库必须是已初始化的私有仓库,Token 需要具备 Contents: Read and write 权限。为遵循最小权限原则,推荐使用仅授权该仓库的 Fine-grained Personal Access Token。

09同步密码和 GitHub Token 会保存吗?

会以加密形式保存在当前电脑。同步密码和 GitHub Token 均使用 Electron safeStorage 保护:Windows 使用 DPAPI,macOS 使用 Keychain。同步密码框清空后,已保存的同步密码也会删除。

10支持哪些系统?

提供 Windows x64 安装包,以及适用于 macOS 12 及以上、兼容 Apple 芯片与 Intel 芯片的 Universal DMG 和 ZIP。macOS 安装包当前尚未进行 Apple Developer ID 签名和公证。

11导入对话后需要重启 Codex 吗?

不需要。导入后的对话可以直接在正在运行的 Codex 应用中打开。

12码渡是 OpenAI 官方工具吗?

不是。码渡是独立第三方工具,并非 OpenAI 官方产品,也不受 OpenAI 背书。Codex 是 OpenAI 的产品名称。

名字的来处

为什么叫「码渡」?

我总把每一段 Codex 对话,想象成一艘载着思路的小船。

码
CODE · CONTEXT

“码”,既是代码,也是我们与 AI 一起积累的上下文。

渡
CROSSING · CONTINUE

“渡”,是把尚未完成的想法,从这台电脑安全送往另一台电脑,让工作在新的地方继续。

数据保存在你的仓库,渡送由你发起;码渡只负责把选中的工作记忆,稳稳送到另一台电脑。

制作者

关于我

我是鹿先森(Lutu AI),一名把 AI 真正用进日常工作的实践者。我持续研究 Codex、自动化工作流和 AI 工具,也把踩过的坑与可复用的方法整理出来。

“工具的价值,不在演示里有多惊艳,而在它能不能接住下一次真实工作。”
Codex 工作流AI 工具实践自动化方法
微信公众号WECHAT
鹿途AI微信公众号二维码
一起把 Codex 用进工作流

微信扫一扫,获取 Codex 工作流、AI 工具与实战更新。

开始渡送

从这台电脑出发。

当前版本 v0.5.0。Windows x64 与 macOS 12+ Universal 安装包现已通过公开 GitHub Release 提供下载;macOS 包当前尚未签名和公证。

⊞
WINDOWS · X64Codex-to-Codex-0.5.0-Setup.exe从 GitHub Release 下载 Windows x64 安装包
下载 Windows 版
⌘
MACOS 12+ · UNIVERSALCodex-to-Codex-0.5.0-macOS-universal.dmg适用于 macOS 12 及以上,兼容 Apple 芯片与 Intel 芯片
下载 macOS 版
01
完整指南查看详细使用说明

从 GitHub Token 配置到第一次同步,按步骤了解码渡的完整使用流程。

打开飞书文档 ↗