Codex-App-Manager

跨平台官方 Codex 桌面应用的安装 / 增量更新 / 干净卸载管理器,内置国内可达的镜像自更新。Cross-platform installer & updater for the official Codex desktop app — i

What is Codex-App-Manager?

跨平台官方 Codex 桌面应用的安装 / 增量更新 / 干净卸载管理器,内置国内可达的镜像自更新。Cross-platform installer & updater for the official Codex desktop app — incremental updates, clean uninstall, China-reachable self-update.

Overview of Codex-App-Manager

What it is

Codex App Manager is a cross-platform desktop client that installs, incrementally updates, and cleanly uninstalls the official OpenAI Codex desktop app. It detects the locally installed Codex, plans and performs install, incremental update, and clean uninstall, and offers one-click launch. It consumes the upstream codex-app-mirror (mirror + Sparkle update feed) to manage the Codex payload, and also self-updates through its own China-reachable mirror. The Manager does not build or modify Codex — it owns only the client-side install and update experience.

Key features

  • One-stop management: detects local Codex install state, plans install/update/uninstall, launches Codex in one click
  • Incremental update (macOS): consumes codex-app-mirror's Sparkle appcast, downloads only delta between versions, verifies EdDSA signatures byte-for-byte, rolls back on failure
  • Windows: MSIX / portable install and staged updates; MSIX health check after install, with a warning on stripped systems
  • Self-update: Manager updates itself via R2 (global) + IHEP S3 (China), with GitHub fallback; signatures sign the bytes, so mirror copies remain valid
  • China-reachable: self-update and payload downloads share the same mirror shortlink, automatically routed by region (IHEP for China, R2 for overseas)
  • 11 languages: follows system language automatically, including Arabic RTL
  • Codex theme skin support: built-in runtime for .codexskin standard, toolchain, and gallery; online skin library, try-on, apply, import

Use cases

Installing the official Codex desktop app on macOS or Windows. Keeping Codex up-to-date with incremental updates (macOS) or staged updates (Windows). Cleanly uninstalling Codex when no longer needed. Managing Codex installations in environments where direct access to official update servers is restricted (e.g., mainland China). Applying custom Codex skins via the built-in skin runtime.

Getting started

macOS — Homebrew (recommended):bashbrew install --cask wangnov/tap/codex-app-managerDirect download: obtain the appropriate installer from the latest GitHub Release or via the agentsmirror mirror link (China-reachable). After downloading, verify the file using SHA256SUMS from the same release. For Windows:powershellGet-FileHash .CodexAppManager_x64-setup.exe -Algorithm SHA256For macOS:bashshasum -a 256 CodexAppManager_aarch64.dmgAfter installation, the Manager will self-update and manage Codex updates automatically.

License and pricing

MIT license. The project is open source (pricing type: open_source). No affiliation or endorsement by OpenAI or Microsoft.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/wangnovcodex-app-manager.svg)](https://yunodb.com/tools/wangnovcodex-app-manager?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/wangnovcodex-app-manager?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/wangnovcodex-app-manager.svg" alt="Featured on YunoDB" height="20"></a>