Skip to content

CodexHub v0.1.0

Choose a tag to compare

@Jurio0304 Jurio0304 released this 30 Jun 15:34

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 run CodexHub.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

  1. Download the installer or portable zip from this release.
  2. On Windows, run CodexHub_0.1.0_x64-setup.exe, or unzip the portable package and run CodexHub.exe.
  3. Keep Windows OpenSSH available; CodexHub uses the system ssh, ssh-keygen, and related tools.
  4. For Codex App integration, CodexHub guides you to Codex App Settings > Codex > Connections; it does not write Codex App private state.

Full documentation:

Validation

This release was validated locally with:

  • pnpm smoke
  • pnpm smoke:mock
  • pnpm typecheck
  • cargo test --manifest-path src-tauri/Cargo.toml
  • pnpm build:web
  • pnpm build:tauri
  • pnpm audit:public
  • pnpm release:portable
  • scripts/check-release-exe.ps1
  • pnpm 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 与发布打包脚本,便于重复验证。

安装

  1. 从本 Release 下载安装包或便携包。
  2. Windows 上可以运行 CodexHub_0.1.0_x64-setup.exe,也可以解压便携包后运行 CodexHub.exe
  3. 请确保 Windows OpenSSH 可用;CodexHub 会调用系统的 sshssh-keygen 等工具。
  4. 与 Codex App 集成时,CodexHub 会引导你前往 Codex App 的 Settings > Codex > Connections,不会写入 Codex App 私有状态。

完整文档:

验证

本版本已在本地通过:

  • pnpm smoke
  • pnpm smoke:mock
  • pnpm typecheck
  • cargo test --manifest-path src-tauri/Cargo.toml
  • pnpm build:web
  • pnpm build:tauri
  • pnpm audit:public
  • pnpm release:portable
  • scripts/check-release-exe.ps1
  • pnpm 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 注册仍需要按引导手动完成。