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.
Last scanned: 5/30/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-30T16:22:56.573Z",
"npmAuditRan": true,
"pipAuditRan": true
}Codex_Relay is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built 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. It has 156 GitHub stars.
Yes. Codex_Relay passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/Red-noblue/Codex_Relay" and add it to your Claude Code skills directory (see the Installation section above).
Codex_Relay is primarily written in TypeScript. It is open-source under Red-noblue on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Codex_Relay against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
跨设备传递/备份 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(会记录一次恢复动作)session_meta.payload.id(默认不改 forked_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