TL;DR

이 리포지토리는 Codex 플러그인 개발을 위한 표준화된 예제 모음으로 각 플러그인이 plugins/<name>/ 구조에 .codex-plugin/plugin.json 매니페스트를 포함하도록 규정하고 마켓플레이스 인덱스를 통해 배포 대상을 관리한다. 매니페스트는 플러그인의 권한과 명령, 통합 지점을 선언하며 런타임은 이를 기반으로 플러그인을 로드하거나 차단하는 구조이다. Figma, Notion, Expo 등 실제 플랫폼 통합 예제가 포함되어 있어 플랫폼별 구현 패턴을 빠르게 참고할 수 있으며, 마켓플레이스 인덱스와 API 키 전용 인덱스가 별도로 제공되어 공개 및 인증 기반 배포를 구분할 수 있다. 단점으로는 README에 빌드·런타임 요구사항이나 구체적 설치 명령이 명시되어 있지 않아 실제 배포 전 플랫폼 문서와 매니페스트 규격을 추가로 확인해야 한다.

주요 기능

• 플러그인 템플릿을 제공하여 각 플러그인이 .codex-plugin/plugin.json 매니페스트를 포함하도록 표준화한다.
• 플러그인별로 skills/, agents/, commands/, hooks.json, assets/ 등 선택적 보조 표면을 포함할 수 있게 구성한다.
• 루트의 .agents/plugins/marketplace.json과 .agents/plugins/api_marketplace.json으로 플러그인 인덱스를 관리한다.
• Figma, Notion, Expo 등 풍부한 예제들을 통해 플랫폼별 통합 패턴과 워크플로를 확인할 수 있게 한다.

어떻게 동작하는가

각 플러그인은 plugins/<name>/ 디렉토리에 위치하며 플러그인의 진입점 역할을 하는 .codex-plugin/plugin.json 매니페스트 파일을 반드시 포함한다. 매니페스트는 플러그인의 권한과 명령, 통합 지점을 선언하고 런타임은 이를 기반으로 플러그인을 로드하거나 차단한다. 마켓플레이스 인덱스는 .agents/plugins/marketplace.json에서 표준 플러그인 디렉토리를 가리키고, API 키 기반 사용자용 별도 인덱스는 .agents/plugins/api_marketplace.json에 저장되어 플랫폼별 배포와 표시를 분리한다.

해결 문제

이 레포지토리는 Codex 플러그인 개발을 시작할 때 필요한 표준화된 예제와 구조를 제공하여 초기 설정과 통합 작업에서 발생하는 반복적인 시행착오를 줄인다. 플러그인 템플릿과 매니페스트 규칙을 통해 플러그인 호환성과 배포 통로(마켓플레이스)를 일관되게 유지할 수 있다. 또한 Figma, Notion, Expo 같은 풍부한 실제 예제들이 플랫폼별 구현 패턴을 구체적으로 참조할 수 있는 기준을 제공한다.

차별점

• 플러그인 매니페스트(.codex-plugin/plugin.json)를 필수 항목으로 규정하여 런타임 호환성 검증이 용이하다.
• 리포지토리 최상위에 마켓플레이스 인덱스를 포함하여 플러그인 목록 관리와 배포 지점을 명확히 분리했다.
• 풍부한 플랫폼별 예제(Figma, Notion, Expo 등)를 함께 제공하여 단순 템플릿 이상의 통합 사례를 제시한다.

사용 사례

• Codex 기반 에이전트에 기능 확장을 추가하려는 개발자가 표준 매니페스트와 디렉토리 레이아웃을 참고하여 플러그인을 신속히 구현할 때 사용한다.
• 플러그인 마켓플레이스에 등재할 패키지를 준비하는 팀이 인덱스 구조(.agents/plugins/marketplace.json)를 따라 배포 구성을 맞출 때 활용한다.
• 플랫폼 통합 사례가 필요한 개발자가 Figma, Notion, Expo 등 예제를 보며 권한 선언과 명령 설계를 학습할 때 참고한다.

시작하기

리포지토리를 복제한 후 plugins/ 디렉토리 내부의 개별 플러그인 폴더를 열어 .codex-plugin/plugin.json 매니페스트와 보조 파일 구조(skills/, agents/, commands/, hooks.json 등)를 확인하면 첫 구현 지점을 파악할 수 있다. 마켓플레이스 인덱스는 .agents/plugins/marketplace.json 파일을 가리키므로 배포 대상 플러그인을 등록하려면 해당 JSON을 갱신하면 된다. README의 디렉토리 경로와 예제 목록을 기준으로 기존 예제를 복제하여 새 플러그인을 작성하면 초기 설정 시간을 단축할 수 있다.

요구사항

• JavaScript 기반 프로젝트 구조로 작성되어 있어 JavaScript 생태계에서의 사용을 전제로 한다.
• .codex-plugin/plugin.json 매니페스트 형식을 이해하고 작성할 수 있어야 한다.
• 플랫폼 통합을 위해 마켓플레이스 인덱스(.agents/plugins/marketplace.json)를 편집할 권한과 파일 접근이 필요하다.