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 설치 — 컴퓨터에 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 다운로드는 하나의 짧은 링크(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 경고가 발생할 수 있음), 자체 업데이트 패키지는 다운로드된 바이트만 확인하고 Windows 게시자 신뢰는 확인하지 않는 Tauri 업데이트 서명을 포함합니다. README에 따르면 유료 클라우드 HSM 인증서가 계획되어 있으나 아직 적용되지 않았으며, 현재 다운로드 파일은 서명된 것으로 설명해서는 안 됩니다.

기술 스택

  • 프론트엔드: React 19, TypeScript, Vite, GSAP (애니메이션)
  • 셸: Tauri v2 (프레임리스 팝오버 창)
  • 백엔드: Rust 명령 계층, 두 개의 별도 엔진 크레이트: 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개의 예제 시나리오를 포함하여 개발자가 이러한 기능을 브라우저, 게임, 코드 리뷰 도구 등에 연결할 수 있도록 돕습니다.