CodexHub v0.1.0
English
CodexHub v0.1.0 is the first public MVP release of the Windows-first desktop control plane for Codex App SSH workflows.
Downloads
CodexHub_0.1.0_x64-setup.exe: Windows x64 NSIS installer.CodexHub-v0.1.0-windows-x64-portable.zip: portable Windows x64 package; unzip and runCodexHub.exe.SHA256SUMS.txt: SHA256 checksums for the installer and portable package.
Highlights
- Windows SSH key detection and non-overwriting Ed25519 key generation.
- CodexHub-managed SSH config blocks with backups, idempotent writes, and unmanaged config preservation.
- SSH host onboarding, connection checks, remote probing, and remote Codex install/update entry points.
- Profile rendering and preview/apply flows for remote Codex configuration.
- Skill import/install flows with validation and path-safety checks.
- Task logs with redaction-oriented safety boundaries.
- Mock mode and release packaging scripts for repeatable local validation.
Install
- Download the installer or portable zip from this release.
- On Windows, run
CodexHub_0.1.0_x64-setup.exe, or unzip the portable package and runCodexHub.exe. - Keep Windows OpenSSH available; CodexHub uses the system
ssh,ssh-keygen, and related tools. - For Codex App integration, CodexHub guides you to Codex App
Settings > Codex > Connections; it does not write Codex App private state.
Full documentation:
- English README: https://github.com/Jurio0304/CodexHub/blob/v0.1.0/README.md
- Chinese README: https://github.com/Jurio0304/CodexHub/blob/v0.1.0/docs/zh-CN/README.md
- Release checklist: https://github.com/Jurio0304/CodexHub/blob/v0.1.0/docs/release-checklist.md
- Public scope notes: https://github.com/Jurio0304/CodexHub/blob/v0.1.0/docs/public-scope.md
Validation
This release was validated locally with:
pnpm smokepnpm smoke:mockpnpm typecheckcargo test --manifest-path src-tauri/Cargo.tomlpnpm build:webpnpm build:tauripnpm audit:publicpnpm release:portablescripts/check-release-exe.ps1pnpm build:installer:nsis
Security Boundaries
- The public repository remains source-only; release binaries are attached to GitHub Releases, not committed.
- CodexHub does not store private keys, passphrases, OpenAI tokens, or remote secrets.
- CodexHub writes only its own managed SSH config blocks and preserves unmanaged user SSH config content.
- Local real hosts, app-state exports, and secrets are excluded from the public release scope.
Known Limitations
- v0.1.0 is an MVP focused on Windows and direct SSH/SFTP workflows.
- MSI packaging is not the primary v1 artifact; the installer attached here is NSIS, and the portable zip remains the safest fallback artifact.
- Live SSH acceptance requires a real remote host supplied by the user.
- Codex App host registration is still a guided manual step.
中文
CodexHub v0.1.0 是第一个公开 MVP 版本,用于在 Windows 桌面上管理 Codex App 的 SSH 多主机工作流。
下载
CodexHub_0.1.0_x64-setup.exe:Windows x64 NSIS 安装包。CodexHub-v0.1.0-windows-x64-portable.zip:Windows x64 便携包,解压后运行CodexHub.exe。SHA256SUMS.txt:安装包和便携包的 SHA256 校验值。
主要内容
- Windows SSH key 检测,以及不覆盖已有 key 的 Ed25519 key 生成。
- CodexHub 托管 SSH config 块写入、备份、幂等更新,并保留用户原有非托管配置。
- SSH 主机添加、连接测试、远端探测,以及远端 Codex 安装/更新入口。
- Profile 渲染、预览和应用流程,用于远端 Codex 配置。
- Skill 导入/安装流程,包含校验和路径安全检查。
- 带脱敏边界的任务日志。
- Mock mode 与发布打包脚本,便于重复验证。
安装
- 从本 Release 下载安装包或便携包。
- Windows 上可以运行
CodexHub_0.1.0_x64-setup.exe,也可以解压便携包后运行CodexHub.exe。 - 请确保 Windows OpenSSH 可用;CodexHub 会调用系统的
ssh、ssh-keygen等工具。 - 与 Codex App 集成时,CodexHub 会引导你前往 Codex App 的
Settings > Codex > Connections,不会写入 Codex App 私有状态。
完整文档:
- 英文 README:https://github.com/Jurio0304/CodexHub/blob/v0.1.0/README.md
- 中文 README:https://github.com/Jurio0304/CodexHub/blob/v0.1.0/docs/zh-CN/README.md
- 发布验收清单:https://github.com/Jurio0304/CodexHub/blob/v0.1.0/docs/release-checklist.md
- 公开范围说明:https://github.com/Jurio0304/CodexHub/blob/v0.1.0/docs/public-scope.md
验证
本版本已在本地通过:
pnpm smokepnpm smoke:mockpnpm typecheckcargo test --manifest-path src-tauri/Cargo.tomlpnpm build:webpnpm build:tauripnpm audit:publicpnpm release:portablescripts/check-release-exe.ps1pnpm build:installer:nsis
安全边界
- 公开仓库保持 source-only;二进制文件只上传到 GitHub Releases,不提交进仓库。
- CodexHub 不保存私钥、passphrase、OpenAI token 或远端 secret。
- CodexHub 只写入自己的托管 SSH config 块,并保留用户原有非托管 SSH 配置。
- 本地真实 hosts、应用状态导出和 secret 不进入公开发布范围。
已知限制
- v0.1.0 是 MVP,重点覆盖 Windows 和直接 SSH/SFTP 工作流。
- MSI 不是 v1 主发布产物;本次附带的是 NSIS 安装包,portable zip 仍是最稳妥的备用产物。
- 完整 live SSH 验收需要用户提供真实远端主机。
- Codex App host 注册仍需要按引导手动完成。