Wangnov/Codex-App-Manager

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

概要

Codex App Managerは、公式OpenAI Codexデスクトップアプリのインストール、更新、アンインストールを管理するクロスプラットフォームデスクトッププログラムです。このマネージャーを実行するだけでCodexアプリ自体を管理できるため、Codexを個別にダウンロードする必要はありません。このマネージャーはCodexをビルドまたは変更するものではなく、Codexのインストールと更新体験を管理するのみです。

機能

  • Codexのインストール — PCにCodexがインストールされているかを検出し、適切なインストールを計画します。
  • Codexの更新 — macOSではバージョン間の差分（「デルタ」パッケージ）のみをダウンロードし、バイト単位で署名を検証して旧バージョンを置き換え、問題が発生した場合は自動的にロールバックします。WindowsではMSIXまたはポータブルビルドを取得し、更新をステージングして、完了後にヘルスチェックを実行します。
  • Codexのアンインストール — クリーンに削除します。
  • Codexの起動 — ワンクリックで起動します。
  • 自己更新 — マネージャー自体も独自のミラーシステム（下記参照）を通じて最新の状態に保たれます。
  • Codexのテーマ化 — awesome-codex-skinsライブラリの公式ランタイムです。ユーザーは実行中のCodexにスキンを即座に適用（試用）したり、永続的に適用したりできます。スキンはChrome DevTools Protocol (CDP) を介して注入されるため、アプリのファイルは一切変更されず、アプリの署名は有効なままです。

プラットフォーム

  • macOS: Apple Silicon (arm64) および Intel (x64)
  • Windows: x64 および ARM64

インストール

  • macOS (推奨): brew install --cask wangnov/tap/codex-app-manager
  • 直接ダウンロード: GitHub Releases、または中国本土でVPNなしで動作するミラーリンク (codexapp.agentsmirror.com) から。

中国でのアクセス性について

マネージャーとCodexのダウンロードは、1つの短いリンク (codexapp.agentsmirror.com) を共有しています。Cloudflare Workerがトラフィックを自動的にルーティングし、グローバルユーザーはCloudflare R2からファイルを取得し、中国本土のユーザーはIHEP S3（中国科学院高能物理研究所）の事前署名済みURLにリダイレクトされます。更新署名はURLではなくインストーラーのバイトに対して行われるため、バイト単位で同一のミラーコピーは有効なままです。

自己更新の順序

  1. 独自のミラー (codexapp.agentsmirror.com/manager/latest.json)
  2. GitHubフォールバック (github.com/Wangnov/Codex-App-Manager/releases/latest/download/latest.json)

これにより、GitHubに全く依存せずに自己更新が可能です。

署名ステータス

  • macOS: Developer ID署名 + Apple公証済み → Gatekeeperが初回起動をブロックすることはありません。
  • Windows: インストーラーは現時点でAuthenticode署名されていません（SmartScreenが警告を出す可能性があります）。自己更新パッケージにはTauriアップデーター署名が含まれており、ダウンロードされたバイトのみを検証し、Windowsのパブリッシャー信頼は検証しません。READMEには有料のクラウドHSM証明書を計画中と記載されていますが、現時点では未実装であり、現在のダウンロードファイルを「署名済み」と説明してはなりません。

技術スタック

  • フロントエンド: React 19, TypeScript, Vite, GSAP (アニメーション)
  • シェル: Tauri v2 (フレームレスポップオーバーウィンドウ)
  • バックエンド: Rustコマンドレイヤー、2つの独立したエンジンクレート: codex-mac-engine (Sparkle) および codex-win-engine (MSIX/ポータブル)

行わないこと

  • Codexインストーラーの変更や再パッケージ化。
  • OpenAI/Microsoftの認証やローカルインストールポリシーのバイパス。
  • Sparkle署名の偽造や再計算（公式署名をそのままコピーします）。
  • 公式OpenAIまたはMicrosoft Store配布の代替品としての利用。

言語サポート

システムロケールから自動選択される11言語（右から左に記述されるアラビア語を含む）。

ライセンス

MIT。本プロジェクトはOpenAIまたはMicrosoftとの提携や推奨関係はありません。

関連

  • プロジェクト
    Aletheore/Aletheore

    Aletheore は、決定的で証拠に基づくコードインテリジェンスツールキットです。リポジトリをスキャンして構造化された証拠ファイル（依存関係グラフ、シークレット、Git 履歴、API マップなど）を生成し、ローカルでクエリしたり、LLM に渡して監査済みレポートを生成したり、軽量な MCP サーバーを介して AI エージェントに公開したりできます。CLI は無料でオフラインで動作します。有料の GitHub App は、自動 PR レビュー、AI 生成ドキュメント、モニタリングを追加します。

  • プロジェクト
    neondatabase/mcp-server-neon

    Neon MCP Server は、LLM 対応エディタ（Claude Code、Cursor、VS Code、Kiro など）からの自然言語リクエストを Neon serverless Postgres API 呼び出しに変換するオープンソースの Model Context Protocol（MCP）サーバーです。ユーザーは SQL を書かずにプロジェクト/ブランチの作成、クエリの実行、マイグレーションを行うことができ、URL クエリパラメータを介して細かいアクセス制御（読み取り専用モード、カテゴリフィルタリング、プロジェクトスコープ）を提供します。Vercel に Next.js アプリとしてデプロイされ、OAuth または API キー認証をサポートし、ローカル開発/IDE 統合を目的としています。

  • プロジェクト
    Agent-Field/pr-af

    動的パイプラインとエビデンスに基づく検証を使用して深いアーキテクチャ監査を実行し、システム全体の脆弱性を発見するオープンソースのエージェント型コードレビュアー。

  • プロジェクト
    wuyoscar/jev-skill

    Jev ベースの AI コーディングエージェント向けの再利用可能な「スキル」のキュレーションコレクション——トリアージ、ドキュメント検索、評価、アクション選択のためのモジュール式プロンプト——さらに 67 のコミュニティデモ、ローカルモデルアダプタ、108 の例示シナリオを含み、開発者がこれらの能力をブラウザ、ゲーム、コードレビューツールなどに組み込むのに役立ちます。