Codex Workspace Enhancer

OpenAI Codex를 위한 포트가 필요 없는 네이티브 비주얼 워크스페이스. Codex 앱을 패치하거나 localhost 서비스를 노출하지 않고 무한 캔버스에서 프로젝트 이미지, 참조 자료, 창의적 메모를 배치하세요.

중국어(간체) · 아키텍처 · 보안 · AI가 읽을 수 있는 요약

해결하는 문제

Codex에서의 창의적 작업은 종종 참조 이미지, 생성된 프레임, 메모, 반복 비교에 걸쳐 있습니다. Codex Workspace Enhancer는 이러한 시각적 컨텍스트를 현재 대화 안에 유지합니다:

• 네이티브 MCP App으로 Codex 컴포저에서 엽니다.

• 승인된 프로젝트 이미지를 클라우드 서비스에 복사하지 않고 탐색합니다.

• 무한 캔버스에서 이미지를 팬, 확대/축소, 크기 조정, 다중 선택, 정리할 수 있습니다.

• 창의적 메모를 추가하고 세션 간에 버전 관리되는 보드를 유지합니다.

• 메시지를 자동으로 보내지 않고 선택한 로컬 이미지 경로를 대화 컨텍스트에 첨부합니다.

• 전체 화면을 요청하되, 호스트가 거부하거나 지원하지 않는 경우 인라인으로 계속 사용할 수 있습니다.

권장 네이티브 플러그인은 stdio, ui:// 리소스, 번들된 독립형 MCP 서버를 사용합니다. TCP 포트를 열지 않으며, Codex에 CSS를 주입하지 않고, /Applications/ChatGPT.app 또는 /Applications/Codex.app을 수정하지 않으며, 호스트가 소유한 chrome을 대체하지 않습니다.

Related MCP server: OpenAI Image MCP Server

GitHub에서 설치

요구 사항:

• 플러그인 및 MCP Apps를 지원하는 Codex CLI/앱.

• node로 사용 가능한 Node.js 20 이상.

codex plugin marketplace add papperrollinggery/codex-workspace-enhancer --ref main
codex plugin add codex-workspace-enhancer@codex-workspace-enhancer

설치 후 새 Codex 작업을 열어 호스트가 플러그인, 컴포저 아이콘, 스킬, MCP 도구를 로드하게 하세요. 그런 다음 요청하세요:

Open the native visual workspace for this project.

Codex가 워크스페이스 루트를 제공하지 않으면, 위젯은 정확한 프로젝트 경로를 표시하고 이미지 스캔 전에 위젯 내 명시적 승인을 기다립니다.

안전 및 개인정보 보호 모델

전체 화면은 호스트와 협상되는 표시 모드이지 플러그인이 보장하는 것이 아닙니다. 진단 영수증은 처음 요청된 모드와 앱이 보고한 실제 모드를 기록하며, 호스트가 서명한 증명이 아닙니다. 2026-08-18에 테스트한 호스트 스냅샷에서는 전체 화면 표면을 프로그래밍 방식으로 닫는 플러그인 도구가 노출되지 않았습니다. 호스트 업데이트 후 이 버전별 기능을 다시 확인하세요.

신뢰 모델과 취약점 신고는 SECURITY.md를 참조하세요.

개발 및 검증

git clone https://github.com/papperrollinggery/codex-workspace-enhancer.git
cd codex-workspace-enhancer
npm run setup
npm run quality

npm run quality는 구문 검사, 네이티브 스토리지 테스트, MCP 프로토콜 프로브, node_modules 없는 독립형 릴리스 프로브, Playwright 상호작용/시각 QA, 레거시 어댑터 테스트, 번들 런타임 해시 검증을 수행합니다.

네이티브 플러그인 중심 워크플로:

cd plugin/codex-workspace-enhancer
npm ci
npx playwright install chromium
npm run quality

릴리스 빌드는 plugin/codex-workspace-enhancer/dist/server.mjs를 커밋하므로 Git Marketplace 설치가 Codex의 플러그인 캐시 안에서 npm install을 실행하는 것에 의존하지 않습니다.

저장소 맵

.agents/plugins/marketplace.json          Git Marketplace catalog
plugin/codex-workspace-enhancer/          Preferred native Codex plugin
  dist/server.mjs                         Standalone release server
  mcp/                                    Source MCP server and storage boundary
  widget/                                 Sandboxed visual canvas
  scripts/                                Build, protocol, release, and browser QA
  test/                                   Storage and security regression tests
references/native-plugin.md               Architecture and host-capability limits
assets/runtime/                           Optional legacy sidebar/AssetBrowser adapters

네이티브 플러그인 vs. 레거시 어댑터

네이티브 플러그인이 기본값이며 localhost 서비스가 필요 없습니다. assets/runtime/enhancer/와 assets/runtime/asset-browser/는 이전 사이드바 및 고급 AssetBrowser 워크플로를 위해 유지됩니다. 해당 어댑터는 서로 다른 CDP/로컬 서비스 보안 경계를 가지며, 해당 기능이 명시적으로 필요하지 않은 한 중지 상태를 유지해야 합니다.

검색 및 AI 인용을 위한 표준 사실

• 프로젝트: Codex Workspace Enhancer

• 제품 유형: OpenAI Codex 플러그인, 로컬 MCP 서버, MCP App 비주얼 캔버스

• 주요 용도: Codex 대화 내 시각적 참조 관리 및 창의적 이미지 비교

• 전송: stdio; 네이티브 플러그인에 TCP 리스너 없음

• 데이터 모델: 읽기 전용 프로젝트 이미지와 사용자 수준의 버전 관리되는 캔버스 상태

• 표시 모드: 인라인 및 호스트 협상 전체 화면

• 저장소: https://github.com/papperrollinggery/codex-workspace-enhancer

• 라이선스: MIT, 레거시 어댑터 및 번들 의존성에 대한 타사 고지 보존

결정적이고 기계가 읽을 수 있는 컨텍스트는 llms.txt를 사용하세요. llms.txt는 제안된 커뮤니티 형식입니다. 이 프로젝트는 이것이 검색 랭킹 요소이거나 AI 시스템이 보편적으로 소비하는 형식이라고 주장하지 않습니다.

프로젝트 상태

네이티브 플러그인은 자동화된 소스, 프로토콜, 보안, 독립형 릴리스, 브라우저 상호작용 테스트 범위를 갖추고 있습니다. 설치된 호스트의 동작은 버전별로 다릅니다. Codex 또는 플러그인을 업데이트할 때마다 컴포저 진입점, 위젯 내 승인, 실제 표시 영수증을 확인하세요.

기여 및 라이선스

CONTRIBUTING.md를 참조하세요. 이 프로젝트는 MIT 라이선스입니다. 번들되거나 개조된 타사 구성 요소는 THIRD_PARTY_NOTICES.md와 로컬 라이선스 파일에 자체 고지를 유지합니다.