Codex App Manager

Wangnov·Wangnov.CodexAppManager

Installer, updater, and uninstaller for the official Codex desktop app.

A cross-platform desktop client to install, incrementally update, and cleanly uninstall the official Codex desktop app, with built-in self-update.

winget install --id Wangnov.CodexAppManager --exact --source winget

Latest 0.5.2·August 11, 2026

Release Notes

Codex App Manager

新增从 GitHub Release 选择历史 Codex 版本,以及对 DMG、ZIP、MSIX 离线安装包的原生校验与降级安装。 Adds historical Codex selection from GitHub Releases plus native verification and downgrade installs for offline DMG, ZIP, and MSIX packages. ✨ 亮点 · Highlights

  • 选择安装版本:直接读取 Wangnov/codex-app-mirror 的分页 GitHub Release 历史,按当前平台与架构列出可安装版本;确认页会明确展示版本、安装包、来源与更新策略,再执行升级、降级或全新安装。 Choose an install version: browse the paginated Wangnov/codex-app-mirror GitHub Release history filtered for the current platform and architecture, then confirm the exact version, asset, source, and update policy before upgrading, downgrading, or installing fresh.
  • 安装离线 Release 包:可以选择已经从 GitHub Release 下载到本机的 macOS .dmg / .zip 或 Windows .msix。离线路径不请求 GitHub,也不使用 Sparkle;管理器会锁定确认时的 SHA-256,并在安装前再次核对同一文件,同时验证平台签名、包身份、架构与版本。 Install offline Release packages: select a macOS .dmg / .zip or Windows .msix already downloaded from GitHub Releases. The offline path makes no GitHub request and does not use Sparkle; the manager pins the SHA-256 shown at confirmation, rechecks the same file before installation, and verifies its platform signature, package identity, architecture, and version.
  • 真实降级与更新控制:历史安装可同时选择是否阻止 Codex 自更新。macOS 通过原子替换与健康检查完成安装,失败自动回滚;Windows 支持 MSIX 强制降级,并在系统无法部署 MSIX 时使用已验证的便携安装回退。 Real downgrades with update control: historical installs can also keep Codex self-updates blocked. macOS uses an atomic swap with health checks and automatic rollback, while Windows supports forced MSIX downgrades and a verified portable fallback when MSIX deployment is unavailable. 🐛 修复 · Fixes
  • 安装中断后可安全恢复:安装事务会在破坏性重命名和回滚前持久记录状态,并把所选自更新策略与最终安装结果一起恢复,避免崩溃或断电后误判已安装版本、丢失回滚材料或留下错误策略。 Recover safely after interruption: install transactions now persist state before destructive renames and rollback, and recover the selected self-update policy from the final on-disk verdict, avoiding false success, lost rollback material, or the wrong policy after a crash or power loss.
  • 暂停下载锁定原目标:恢复普通更新或历史版本下载时会继续用户最初确认的精确版本、构建、安装路径和 Windows 安装方式;即使后台版本列表已刷新,也不会静默改装成新的最新版。 Paused downloads retain the confirmed target: resuming either a normal update or a historical install keeps the exact version, build, install path, and Windows route originally approved, even if the latest catalog changes in the meantime. 📦 安装与升级 · Install & Upgrade 已经安装? 打开应用即可收到本次更新——macOS 只下载版本间的增量,校验失败自动回滚。 Already installed? The app offers this update in-app — macOS pulls only the delta, with automatic rollback. ─────────────────────┬─────────────────────────────────────────── 平台 · Platform │下载 · Download(国内直连 · China-reachable) ─────────────────────┼─────────────────────────────────────────── macOS · Apple Silicon│CodexAppManager_aarch64.dmg ─────────────────────┼─────────────────────────────────────────── macOS · Intel │CodexAppManager_x86_64.dmg ─────────────────────┼─────────────────────────────────────────── Windows · x64 │CodexAppManager_x64-setup.exe ─────────────────────┼─────────────────────────────────────────── Windows · ARM64 │CodexAppManager_arm64-setup.exe ─────────────────────┴─────────────────────────────────────────── Windows 签名状态: 本版 CodexAppManager_x64-setup.exe / CodexAppManager_arm64-setup.exe 没有 Authenticode 代码签名,首次运行可能出现 SmartScreen 提示;.sig / latest.json 的 Tauri updater 签名只校验更新字节,不代表 Windows 发行者身份。SignPath Foundation 申请仍在审核。参见 代码签名政策与 Windows signing and verification。 Windows signing status: This release's CodexAppManager_x64-setup.exe / CodexAppManager_arm64-setup.exe are not Authenticode-signed, so SmartScreen may warn on first run. The Tauri updater signature in .sig / latest.json verifies update bytes only and is not Windows publisher identity. The SignPath Foundation application is pending. See the code signing policy and Windows signing and verification. 隐私 · Privacy: 隐私政策 · Privacy policy 核验下载: 本页 Assets 带有 SHA256SUMS;Windows 用 Get-FileHash .\CodexAppManager_x64-setup.exe -Algorithm SHA256 或替换为 ARM64 文件名,macOS 用 shasum -a 256 CodexAppManager_aarch64.dmg,再与 SHA256SUMS 比对。 Verify downloads: This release includes SHA256SUMS in Assets; on Windows run Get-FileHash .\CodexAppManager_x64-setup.exe -Algorithm SHA256 or swap in the ARM64 filename, and on macOS run shasum -a 256 CodexAppManager_aarch64.dmg, then compare with SHA256SUMS.

macOS · Homebrew

brew install --cask wangnov/tap/codex-app-manager

镜像直链恒指向最新版本;如需本页对应的历史版本,请使用下方 Assets。.app.tar.gz / .sig / latest.json 是自动更新器的工件,手动安装请选 .dmg / .exe。 Mirror permalinks always resolve to the latest release — for this exact version use the assets below. .app.tar.gz / .sig / latest.json belong to the auto-updater; pick the .dmg / .exe for manual installs. What's Changed

  • chore(deps): bump base64 from 0.22.1 to 0.23.0 in /src-tauri by @dependabot[bot] in #239
  • chore(deps-dev): bump globals from 17.7.0 to 17.8.0 by @dependabot[bot] in #244
  • chore(deps): bump libc from 0.2.188 to 0.2.189 in /src-tauri by @dependabot[bot] in #242
  • chore(deps-dev): bump @vitejs/plugin-react from 6.0.3 to 6.0.4 by @dependabot[bot] in #243
  • chore(deps-dev): bump jsdom from 29.1.1 to 30.0.1 by @dependabot[bot] in #241
  • fix(themes): harden composer scroll ownership by @Wangnov in #248
  • fix(themes): invalidate composer overflow cache by @Wangnov in #249
  • chore(deps): bump actions/attest from 4.2.0 to 4.2.1 by @dependabot[bot] in #250
  • chore(deps-dev): bump vite from 8.1.5 to 8.2.0 by @dependabot[bot] in #251
  • chore(deps-dev): bump @types/react from 19.2.17 to 19.2.18 by @dependabot[bot] in #252
  • chore(deps-dev): bump @vitejs/plugin-react from 6.0.4 to 6.0.5 by @dependabot[bot] in #254
  • chore(deps-dev): bump @types/react-dom from 19.2.3 to 19.2.4 by @dependabot[bot] in #253
  • feat(themes): add CSP-safe motion video intros by @Wangnov in #226
  • feat: install historical GitHub Release builds by @Wangnov in #257
  • chore(release): bump version to 0.5.2 by @Wangnov in #258 Full Changelog: v0.5.1...v0.5.2

Installer type: nullsoft

x64F8593801199565BA31E23B977F21B0CAF104AB00D1423F9D207A9E5718115448
arm64DB4A99F3D55ACC9E723D39464D2688358F46B1050D109D1D67E21027670DBFA3

Details

Homepage
https://github.com/Wangnov/Codex-App-Manager
License
MIT
Publisher
Wangnov
Support
https://github.com/Wangnov/Codex-App-Manager/issues
Moniker
codex-app-manager

Tags

codexinstalleropenaitauriupdater

Older versions (18)

0.5.1
x6457B8E0FC37B2C56E6C74311A90CAB232F0B5C52D715C5283CC22A04509618B4A
arm64598437687CAE95B8586871FD95FE5BF8C84A1DF554DA0B619314E40DDC2735D5
0.5.0
x6459CDFB3BE9A3A8F1FE33207DBDADA96010C30AC345F888D345E20D5F06B33AE1
arm6472B563BC513FE7FF784305F86888A3A2901CECAF9D9F503EA1C5218807D8D556
0.4.1
x642BC183771A51355158BEDD6B658A90E53B608ED926A35CD10485784384594128
arm641C8BD300718FFAF13519C19FB5E3428078C180DB7027A6531A18867E44519E01
0.4.0
x6427242684544534BF45F27A5A44813C47D5E18FCCA9B3BA28771261AC17C852D0
arm6430AEF0B7E7337B25A4D437B5FDE8FBA3BC2D4E0E919F967ED4101A667D7E4E32
0.3.3
x6491C3F0BC7F584671C0F503E4207177F4C4764BEC5CBC9E2688789B66C47CC792
arm646D839D9D3CE01C3BD15D4A2C92C46C0B3E4CDAC07A698633DB53E9A09C616A70
0.3.2
x64CEBB75591004984A6BE241CA167A1E8EE7F385D2498E1DFED4B746729E1E0EFA
arm6426B01DF51B8608104EBBC4E366714D3822BE331E04022B55CEC5A367E84152F2
0.3.0
x6443D9AB148808694653200CA525013743005C3C74835902ADAFCA355D00C9DDA6
arm644811884C9BC18B3EFCD900ECEC2931A1395E0DAFC04922C5208D9A79B8009787
0.2.4
x64529242FE2DE5CE22572A789E855400AEFFEE01A8815DAB90A7D910E1CDBA102F
arm64AFFC79CB79DF63D2E4F6A9E431CA3D8494DDF528AB05B7F197A9720DF4835389
0.2.3
x648D628B48BD1107B4A5D454865D9A55A9821C8F0F4846B55384FEEF6D49522CDC
arm646805707C294A34BBBD9BF6676448BA569D96207C1B78606757B299164F2B07CC
0.2.2
x64A562B5A24A80EEBBFA484417DA63AB2DE9081659D14539E71D4955A9F229A7F4
arm642DD584B02CF58699840E28674F61CF63B421766B2844DB7AFE2F2A44A78C5DD9
0.2.1
x6400DA8FF1E4F527899B55A597FD04C57037046B7E7C44BE4CC8A240252581A003
arm6458AE92A36DA2F534AD136841FADF0C434853E55D54F72D07F1D1E0F571A76F15
0.2.0
x646E25E06D8E5045692A68B9FC3A5914AC954D97BA72DC0B7B4E3CF2575471FB0A
arm64EE68BAF41918F512805EDC20EFE180B02FB4044F1E991E82B4FE5F70FFFA3F6A
0.1.22
x641AD74542A9C5E944F7994C8C4E3D548281162B50A503B0ACE9410D8FF9D25DCA
0.1.21
x64A5A666509EAB681746E5FAFF4E48C36D88C769122D6EBB78B1DE4750DF87F333
0.1.20
x64D09C2D04B4F237CF1912AE75C1357A4401DBF46D35DE7414D59D9B0BB7F52F1B
0.1.19
x6481FEF2687CF7F27C23F07D10B06506D050E94243B32267BA1FD30C32BAC25E11
0.1.14
x649015CD34326B8CAE3157ABDB3DE333D60C640407B943BC6A80E6DDE2A46D798E
0.1.10
x6475705F3FF9F1FCAC5ADF118618EDAE8BABCF32F3C73109B434F69608EE506C02