codex-plusplus —
Codex 데스크탑 앱의 BetterDiscord식 tweak 시스템

OpenAI Codex 데스크탑 앱을 — "내가 원하는 대로 뜯어고치는" 비공식 tweak 시스템. Electron app.asar 패치 + Loader/Runtime/Tweak의 3단 분리 + ESM 모듈로 작성된 tweak. 한 줄 설치 curl ... | bash. macOS·Linux·Windows. JavaScript 53% / TypeScript 45%. 3,200+ stars의 레포가 TrendShift 19위에 오른 이유 — 사용자가 직접 IDE를 모드한다는 시대 정신.

0먼저, "왜 이게 만들어졌나"부터

OpenAI Codex 데스크탑 앱이 — 부족한 부분을 사용자가 직접 채운다는 발상.

OpenAI는 2025년 후반 — Codex 데스크탑 앱을 출시했다. ChatGPT의 코딩 모드를 — Electron으로 패키징한 IDE. 강력하지만, 모든 IDE처럼 — 사용자마다 원하는 게 다르다. 어떤 키보드 단축키를 추가하고 싶고, UI 레이아웃을 살짝 바꾸고 싶고, 더 작은 폰트를 쓰고 싶다.

OpenAI에 "기능 추가해주세요" PR하는 것보다 — "내가 그냥 직접 패치한다"가 더 빠른 사람이 있다. 그게 codex-plusplus다. BetterDiscord, Vencord의 — Codex 버전. Discord를 사용자가 직접 모드하는 문화가 — Codex 데스크탑에도 도착.

핵심 기술적 도전: Electron 앱의 코드 사인을 우회하면서 — 자동 업데이트(Sparkle)가 패치를 덮어쓰는 걸 막는다. app.asar 패치, ElectronAsarIntegrity SHA-256 재계산, macOS ad-hoc re-sign, 런치 에이전트로 업데이트 후 자동 재패치. "Electron 앱 내부를 정확히 이해해야 가능한 것"이라 — 기술적 진입장벽이 높다.

1한 줄 요약

전체 글의 핵심 메시지.

2왜 트렌딩하는가

37 stars의 신생이 — TrendShift 19위에 올라온 모멘텀 이유.

① "OpenAI Codex 데스크탑 앱의 부족함"이라는 깔린 수요. Cursor·Claude Code 같은 경쟁자에 비해 — Codex 앱은 UI·단축키·확장성에서 아직 약하다. 사용자가 — "내가 직접 고친다"로 향하는 게 자연스럽다. 그 출구가 codex-plusplus.

② "BetterDiscord 패턴의 정통성". Vencord·BetterDiscord가 — 사용자 수십만 명에게 검증된 패턴. "앱을 패치하지만 — 안정성을 유지하는 법"이 그 커뮤니티에 다 정리되어 있다. codex-plusplus는 — 그 패턴을 단순 이식.

③ "한 명의 인디 개발자 vs 거대 회사" 서사. README 위에 — "Status: alpha. PRs welcome.". 한 명(@b-nnett)이 — OpenAI를 상대로 비공식 modding 시스템을 만든다는 — DIY 정신. 모멘텀 폭발의 정확한 형태.

④ "사용자가 직접 IDE를 모드한다는 시대 정신". Cursor·Claude Code는 — 회사가 제공하는 SKILL.md·Plugin 시스템을 따라야. 반대로 — codex-plusplus는 사용자가 직접 — 회사 권한 없이 패치. "AI 코딩 도구의 BetterDiscord화"를 — 좋아하는 사람은 분명히 있다.

3기술 스택

Electron + Node.js + 깊은 OS-specific 마법.

3-1. 코어 기술

Electron asar (앱 패치), node:crypto SHA-256 (무결성 재계산), plist 파싱 (macOS), codesign CLI (macOS ad-hoc 서명), launchd (macOS) / systemd (Linux) / Task Scheduler (Windows) — 자동 재패치용.

3-2. Tweak 모듈 시스템

ESM(ECMAScript Module) 기반. manifest.json(이름·버전·작성자·githubRepo) + index.js(start()/stop() 생명주기). 런타임이 — .ts도 즉석 트랜스파일. "hot-reloadable" — 저장하면 즉시 반영.

3-3. SDK

@codex-plusplus/sdk 패키지가 — tweak 작성용 API 제공. api.settings.registerPage()(설정 패널 등록), api.log.info()(로그), api.commands.add()(명령어 추가) 등. "VSCode 확장 API의 미니어처".

3-4. 자동 업데이트 회피

OpenAI Codex는 — Sparkle(macOS·Linux) 또는 자체 업데이터로 자동 업데이트. 업데이트 시 — codex-plusplus 패치가 덮어쓰여진다. 해결: launch agent(macOS Launch Daemon)가 — 업데이트 감지 후 자동 re-patch. 사용자 개입 0.

4아키텍처 심화 분석 — 3단 분리의 우아함

"건드릴 곳 적게, 갈아낄 곳 많게"의 패턴.

[Codex.app 본체]                              ← 한 번만 패치
  └── Contents/Resources/app.asar
        └── 진입점이 → loader.cjs 로 교체 (한 줄 require)

       ┌──── loader가 부팅 시 작동 ────┐
       │                              │
       ▼                              ▼
[Runtime in user-data-dir]      [Tweaks in user-data-dir]
  ~/Library/Application         ~/Library/Application
  Support/codex-plusplus/       Support/codex-plusplus/
       runtime/                     tweaks/
       ↑                              ↑
       hot-reloadable                hot-reloadable
       (GitHub release로 업데이트)    (사용자가 자유 추가)

  ┌─── 자동 업데이트 ───┐
  │  GitHub Codex++   │     [Update Watcher]  (launch agent)
  │  새 release 감지   │ →   업데이트 시 자동 repair
  │  daily 확인        │     (asar 다시 패치)
  └────────────────────┘

핵심 설계 패턴 4가지

5디렉토리 구조 해부

monorepo + 디스크 위 사용자 디렉토리.

codex-plusplus/  (저장소)
├── docs/
│   ├── ARCHITECTURE.md        ← 시스템 전체 그림
│   ├── WRITING-TWEAKS.md      ← Tweak 작성 API
│   └── ...
├── packages/                  ← monorepo (npm workspaces)
│   ├── installer/             - install.sh가 깐 CLI (uninstall, status, repair, doctor)
│   ├── loader/                - app.asar 안에 들어가는 진입 stub
│   ├── runtime/               - tweak 발견·로드·생명주기 관리
│   ├── sdk/                   - @codex-plusplus/sdk — tweak 작성용 API
│   └── native-host/           - native OS bridge (Objective-C++)
├── tweaks/                    ← tweak 작성 가이드
│   └── AGENTS.md              - tweak 작성 가이드
├── install.sh                 ← 한 줄 설치 스크립트
├── CHANGELOG.md
├── SECURITY.md                ← 보안 모델 + 신고 정책
├── package.json               ← npm workspaces
├── tsconfig.base.json
└── README.md

사용자 디스크 상태 (설치 후):
~/Library/Application Support/codex-plusplus/       (macOS)
├── source/                    ← Codex++ CLI 소스 (repair·uninstall용)
├── runtime/                   ← 부팅 시 로드되는 본체
├── tweaks/                    ← ESM 모듈 + manifest 모음
├── backup/                    ← 패치 전 asar 백업 (uninstall 시 복원용)
└── config.json                ← 사용자 설정

흥미로운 디테일: monorepo로 잘 쪼개져 있다. 5개 패키지 — installer / loader / native-host / runtime / sdk. 각자 독립 build·테스트. "신생 alpha 레포지만 — 아키텍처는 성숙". 메인테이너가 — Discord 모드 커뮤니티 경험자일 가능성 높다.

6학습 포인트 — 이 레포에서 무엇을 가져갈 것인가

Electron 내부 + 사용자 모드 시스템 디자인 양쪽.

6-1. Electron 앱 내부 해부

app.asar 구조, Info.plist의 ElectronAsarIntegrity, codesign 메커니즘. Electron 앱을 — 외부에서 합법적으로 모드하는 법의 교과서. 자기 회사 Electron 앱의 — 디버깅·확장·QA에도 그대로 응용 가능.

6-2. 사용자 모드 시스템 디자인 — Loader/Runtime/Tweak

"앱 본체 거의 안 건드리고 — 무한히 확장 가능한 구조"의 패턴. 자기 앱을 — 이 구조로 설계하면 — 사용자가 자발적으로 확장 생태계를 만들어 준다. VSCode가 — 같은 원리로 확장 1만+ 개를 가졌다. 작은 앱도 같은 패턴 가능.

6-3. SHA-256 무결성 우회의 정직한 구현

"무결성 검증을 우회한다"는 — 보안 관점에선 위험할 수 있다. 그런데 README에 — 모든 step을 명시하고 SECURITY.md를 따로 둔다. "사용자가 알고 동의하는 우회". 자기가 — 보안 민감 도구를 만들 때 — 어떻게 사용자에게 정직할지의 모범.

6-4. macOS·Linux·Windows 자동 워치독 패턴

3개 OS에서 — "백그라운드 워치독으로 자동 작업"을 동일하게 구현. macOS는 LaunchAgent, Linux는 systemd unit, Windows는 Task Scheduler. 크로스 플랫폼 데몬의 모범. 자기 CLI에 — 같은 패턴 적용 가능.

6-5. BetterDiscord/Vencord 케이스 스터디

이 레포의 본질은 — "Discord 모드 커뮤니티의 10년 노하우를 Codex 앱에 단순 이식". 자기가 좋아하는 데스크탑 앱(Slack, Spotify, Notion)의 — 모드 시스템을 디자인할 때 — 같은 패턴을 그대로 쓸 수 있다.

7시스템·하드웨어 요구사항

매우 가볍다.

8직접 해볼 수 있는 실습 과제

난이도별 4개.

9관련 기술 심화 학습 로드맵

이 레포에서 출발해 — Electron 모드·시스템 디자인으로.

10핵심 키워드 사전

레포·생태계 안에서 자주 보는 용어.

11참고 링크

레포·관련 자료.

레포 본체: github.com/b-nnett/codex-plusplus

문서: ARCHITECTURE.md · WRITING-TWEAKS.md · SECURITY.md

유사 모드 매니저: Vencord(Discord), BetterDiscord, Spicetify(Spotify).

OpenAI Codex 앱: chatgpt.com/codex

분석 대상: b-nnett/codex-plusplus · TrendShift 19위(2026.05.21) · 3,200+ stars · MIT License · JavaScript 53% / TypeScript 45% · 작성: 유행레포정리 프로젝트