by Red-noblue
Cross-device export/import + local vault for Codex CLI sessions (.jsonl). Resume the same session on macOS/Windows/Manage, backup, and transfer Codex CLI sessions (.jsonl) across devices with preview + conflict-safe import.Linux.
# Add to your Claude Code skills
git clone https://github.com/Red-noblue/Codex_RelayGuides for using cli tools skills like Codex_Relay.
跨设备传递/备份 Codex CLI session(.jsonl)的桌面管理工具(macOS / Windows / Linux)。
目标:让你在不同电脑/不同系统上,也能通过 codex resume <session_id> 继续同一个会话(通过导出/导入 session 文件实现)。
注:本项目为社区工具,和 OpenAI 无官方从属关系。
技术栈:Tauri v2 + React + TypeScript + SQLite(后端 Rust)。
Codex CLI 会把会话写在本地 CODEX_HOME/sessions/**/rollout-*.jsonl(默认常见路径:~/.codex/)。
CodexRelay 负责:
CODEX_HOMEcodex resume <session_id>CODEX_HOME/sessions/**/rollout-*.jsonlbundle.zip(manifest.json + rollout.jsonl)bundles/*.zip,可选 batch_manifest.json)session_id 且指纹不同 -> “改 ID 导入”(保留两条分叉都可 resume)CODEX_HOME(会记录一次恢复动作)No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
session_meta.payload.idforked_from_id相关格式说明:docs/BUNDLE_FORMAT.md
codex resume <session_id>pnpm install
pnpm tauri dev
pnpm install
pnpm tauri build
产物目录(不同平台会生成不同格式):
src-tauri/target/release/bundle/**
bundle/dmg/*.dmgbundle/nsis/*-setup.exe(需要在 Windows 上构建;或用 GitHub Actions)bundle/deb/*.deb注:为避免 Linux 产物过大(AppImage 往往会打包大量依赖导致体积显著增大),当前默认只构建 deb;如需 AppImage / rpm,可在 src-tauri/tauri.conf.json 的 bundle.targets 里补回。
结论:如果不做 Apple Developer ID 签名 + 公证(notarization),从浏览器下载的 DMG/App 很可能会被 macOS Gatekeeper 拦截并提示“已损坏,无法打开”(这是系统安全机制,并非一定是包真的坏了)。
免费分发场景下,通常只能给用户提供“放行”方式:
如果你是自己使用(信任该来源),可以在把 App 拖到 /Applications 后执行:
sudo xattr -dr com.apple.quarantine /Applications/CodexRelay.app
GitHub Actions:见 .github/workflows/build-bundles.yml(支持手动触发 workflow_dispatch;打 tag v* 会自动构建并发布 GitHub Release,附带 SHA256SUMS.txt 校验文件)。
提供一个 Homebrew Tap(由另一个账号维护):star-alp/homebrew-tap-CodexRelay
brew tap star-alp/tap-codexrelay
brew install --cask codexrelay
注:Homebrew 的 --no-quarantine 参数已 deprecated(未来可能移除)。如遇 Gatekeeper 拦截,请按上文右键“打开”或执行 xattr 放行即可。
brew tap star-alp/tap-codexrelay && brew update && (brew upgrade --cask codexrelay || brew install --cask --force codexrelay)
brew list --cask codexrelay 能查到):
brew update && brew upgrade --cask codexrelayError: Cask 'codexrelay' is not installed.,说明你之前不是通过 Homebrew 安装(例如手动 DMG 拖拽):
.dmg,将 App 拖到 /Applications 覆盖即可(如遇 Gatekeeper,按上文 xattr 放行)。/Applications/CodexRelay.app,不影响应用数据/存档库):
brew tap star-alp/tap-codexrelay && brew install --cask --force codexrelay设置 -> 更新 -> 检查更新(会提示最新版本并提供打开 Release 的按钮)。codex, codex-cli, session, resume, jsonl, backup, export, import, cross-device, cross-platform, tauri, rust, react, typescript, sqlite, homebrew, cask, macos, windows, linux