TL;DR

Codex Dream Skin은 로컬 CDP 주입을 이용해 Codex 데스크톱의 배경 이미지를 교체하고 프리셋을 관리하는 도구이다. 이 방식은 .app이나 app.asar 같은 공식 설치 파일을 변경하지 않고 렌더링 계층에 배경 레이어를 삽입해 네이티브 UI 컨트롤을 유지하며 macOS와 Windows용 스크립트로 설치와 원클릭 전환을 제공한다. 로컬 CDP는 127.0.0.1에만 바인딩되도록 설계돼 외부 접근을 차단하며 API 키나 모델 설정을 자동으로 바꾸지 않는 분리된 동작 경계가 설정돼 있다.

주요 기능

• Codex UI의 배경 이미지를 16:9 비율에 맞춰 자동으로 조정해 테마로 적용한다
• 사이드바·카드·프로젝트 선택·입력창 등 원래의 네이티브 컨트롤을 유지한 채 배경 레이어를 교체한다
• macOS의 메뉴바와 Windows의 시스템 트레이를 통한 로컬 테마 저장 및 원클릭 전환을 지원한다
• 프리셋을 저장하고 스크립트로 즉시 전환하며 필요 시 한 번의 동작으로 공식 외관을 복구한다
• 프리셋과 배경 생성 가이드를 함께 제공해 사용자 제공 이미지 또는 생성 이미지를 표준화된 해상도로 파생해 사용한다

어떻게 동작하는가

로컬 CDP 인젝션으로 Codex 데스크톱의 렌더링 계층에 배경 이미지 레이어를 삽입해 원본 UI 컨트롤을 그대로 노출시키는 방식으로 동작한다. 이 과정에서 앱의 .app, app.asar, WindowsApps 같은 공식 설치 파일은 변경하지 않아 코드 서명과 무결성에 영향을 주지 않는다. CDP 바인딩은 127.0.0.1 루프백에만 열리도록 구성되어 로컬 전용 통신 채널을 형성한다.

해결 문제

기본 Codex 데스크톱에서 배경·테마를 바꾸려면 종종 앱 내부 파일을 수정하거나 비공식적인 패키지 편집을 해야 했고 이로 인해 서명·무결성 문제가 발생했다. 이 레포는 로컬 CDP 주입으로 UI 계층만 교체해 배경과 분위기를 바꾸는 방식을 제공해 바이너리 변경 없이 테마 적용을 가능하게 했다. 또한 macOS와 Windows용 설치·전환 스크립트를 제공해 사용자가 손쉽게 프리셋을 적용하거나 원상복구할 수 있도록 설계됐다.

차별점

• 앱 바이너리나 app.asar을 직접 수정하지 않고 CDP 주입으로 테마를 적용해 서명 무결성을 보존한다
• macOS 메뉴바와 Windows 시스템 트레이 모두에서 로컬 테마 저장 및 원클릭 전환을 제공해 플랫폼별 사용자 경험을 통일했다
• 프리셋 패키지에 실제 Codex UI를 적용한 실측 스크린샷을 포함해 미리보기와 즉시 적용 흐름을 검증했다

사용 사례

• 개인 개발 환경에서 배경 이미지를 바꿔 작업 분위기와 집중도를 조정하는 데 사용된다
• 팀이나 데모 환경에서 특정 브랜딩·비주얼 콘셉트로 Codex 화면을 통일해 시연용 화면을 구성하는 데 사용된다
• 사용자가 제공한 이미지나 레포의 생성 가이드를 따라 새 배경을 만들어 표준 해상도로 파생해 테마로 배포하는 데 활용된다

시작하기

레포 루트에 플랫폼별 설치 스크립트가 포함돼 있어 macOS에서는 macos 디렉터리로 이동해 제공된 설치 스크립트를 실행하고, 설치 후 제공된 switch-theme 스크립트로 프리셋을 적용하면 된다. Windows에서는 windows/scripts 폴더의 install-dream-skin.ps1을 실행한 뒤 start-dream-skin.ps1으로 에이전트를 시작하면 시스템 트레이에서 프리셋을 선택할 수 있다. 추가 가이드는 macos/README.md, windows/SKILL.md, docs/platforms.md에 정리되어 있다.

요구사항

• Codex 데스크톱이 설치된 상태여야 한다
• macOS 또는 Windows 환경에서 플랫폼별 설치 스크립트를 실행할 수 있어야 한다
• 로컬 루프백(127.0.0.1)에 바인딩되는 CDP 통신을 허용해야 한다

이미지 분석