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