openai/plugins: Codex 에이전트용 플러그인 생태계가 열렸다

GitHub 트렌딩에 하루 +215스타. openai/plugins는 OpenAI가 Codex 에이전트용으로 공개한 공식 플러그인 예제 레포다. Figma 디자인 편집부터 Notion 회의록 자동화, SwiftUI 앱 빌드, Netlify 배포까지 — 실무에서 바로 쓸 수 있는 플러그인 구조가 한 레포에 모여 있다. 아직 생태계 초기지만 구조는 지금 파악해 두는 편이 낫다.

이게 뭔가

Codex 에이전트는 클라우드 샌드박스에서 코드를 직접 작성하고 테스트하고 PR을 올리는 자율 코딩 에이전트다. openai/plugins는 그 에이전트에 외부 서비스를 연결하는 플러그인 예제 모음이다. 각 플러그인은 plugins/<name>/ 디렉터리 아래에 .codex-plugin/plugin.json 매니페스트를 필수로 가지며 선택적으로 skills/, .app.json, .mcp.json, agents/, commands/, hooks.json, assets/를 포함할 수 있다. 쉽게 말하면 "Codex에게 이 서비스를 이렇게 쓰라"고 알려주는 설명서 묶음이다.

왜 지금 뜨는가

첫째, Codex 에이전트 자체의 성숙이다. 2025년 5월 출시된 Codex는 병렬 샌드박스 실행, GitHub PR 자동 생성, 멀티파일 편집을 지원한다. 에이전트가 쓸 만해지자 "무엇을 꽂을 수 있나"는 궁금증이 폭발했다. 둘째, MCP 표준 확산이다. Anthropic이 개발하고 OpenAI가 2025년 초 공식 채택한 Model Context Protocol이 플러그인 연동의 공통 레이어가 되면서 생태계 진입 비용이 낮아졌다. 셋째, Figma·Notion 같은 킬러 예제의 존재다. 추상적인 SDK가 아니라 "Figma에서 코드를 캔버스로 올리는 플러그인"이 실제로 들어 있으니 포크와 스타가 빠르게 쌓인다.

핵심 기능

레포에 포함된 주요 플러그인과 기능은 다음과 같다.

플러그인	주요 기능
figma	use_figma, Code to Canvas, Code Connect
notion	기획, 리서치, 회의록 자동화
build-ios-apps	SwiftUI 앱 빌드
build-macos-apps	macOS 앱 빌드
build-web-apps	배포, UI, 결제, 데이터베이스
expo	React Native, EAS 빌드
netlify	정적 사이트 배포 자동화
remotion	코드 기반 영상 생성
google-slides	슬라이드 자동 생성

매니페스트 구조는 단순하다. plugin.json이 에이전트에게 플러그인의 정체와 진입점을 알려주고, .mcp.json이 MCP 서버 연결 설정을 담는다.

누구에게 쓸모 있나

프론트엔드·풀스택 개발자라면 build-web-apps와 netlify 플러그인으로 Codex가 배포까지 끝내는 파이프라인을 구성한다. 디자인-개발 경계의 협업자라면 figma 플러그인의 Code Connect 기능이 디자인 토큰과 실제 코드를 동기화하는 데 쓸모 있다. 모바일 개발자는 build-ios-apps와 expo로 SwiftUI·React Native 코드 생성을 자동화한다. 스타트업 1인 개발자에게는 Codex + Netlify + Notion 플러그인 조합이 기획-개발-배포 루프를 크게 줄여준다.

시작하기

레포 README 기준 구조는 다음과 같다.

# 레포 클론
git clone https://github.com/openai/plugins.git
cd plugins

# 원하는 플러그인 디렉터리로 이동
cd plugins/notion

각 플러그인 디렉터리 안의 .codex-plugin/plugin.json이 핵심이다. Codex에 플러그인을 로드하려면 이 매니페스트 경로를 에이전트 설정에 지정한다.

// .codex-plugin/plugin.json 기본 구조
{
  "name": "notion",
  "version": "1.0.0",
  "description": "Planning, research, and meeting automation via Notion",
  "surfaces": ["skills", "commands"],
  "mcp": ".mcp.json"
}

MCP 서버 연결은 .mcp.json에서 별도로 정의한다.

// .mcp.json 예시 (Notion 플러그인)
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAI_API_KEY": "<your-key>",
        "NOTION_API_KEY": "<your-notion-key>"
      }
    }
  }
}

사용 예시

Figma 플러그인 — 코드를 캔버스에 올리기

// plugins/figma/skills/code-to-canvas.js
// Codex가 생성한 컴포넌트 코드를 Figma 캔버스에 직접 반영하는 스킬 진입점
export async function codeToCanvas({ code, frameId }) {
  return figma.use_figma({ action: "insert", code, target: frameId });
}

Codex가 작성한 React 컴포넌트를 Figma 프레임에 자동 삽입한다.

Notion 플러그인 — 회의록 자동 생성

// plugins/notion/commands/meeting-notes.js
// 슬랙 스레드나 텍스트를 받아 Notion 페이지로 정리하는 커맨드
export async function createMeetingNotes({ transcript, pageId }) {
  return notion.createPage({ parent: pageId, content: summarize(transcript) });
}

회의 내용을 텍스트로 넘기면 Notion 페이지가 자동 생성된다.

Expo 플러그인 — EAS 빌드 트리거

# plugins/expo/hooks.json에 정의된 훅이 커밋 후 자동 실행
# Codex가 코드 수정 후 EAS 클라우드 빌드를 직접 트리거
eas build --platform all --profile preview

Codex가 React Native 코드를 수정한 뒤 EAS 빌드까지 자동으로 이어간다.

한계·주의

생태계가 초기인 만큼 명확한 한계가 있다. 매니페스트 표준이 아직 유동적이다. plugin.json 스펙이 공식 문서화 없이 예제 코드로만 존재하므로 하위 호환성을 보장받기 어렵다. 클라우드 샌드박스 비용이 작업당 발생하며 복잡한 태스크일수록 비용이 빠르게 오른다. 보안 검토가 필수다. Codex에 GitHub 쓰기 권한을 주면 에이전트가 PR을 자율 생성하므로 프로덕션 레포에는 브랜치 보호 규칙과 리뷰 게이트를 설정해 두는 게 안전하다. JavaScript 편중도 있다. 현재 예제 대부분이 JS/TS 기반이며 Python, Go 등 다른 언어 생태계 지원은 아직 얇다.

---

총 에이전트 4개 (레포 파싱 · 트렌딩 조사 · Codex 생태계 · 본문 합성), 토큰 61,693, 소요 128초. @@META@@ / @@BODY@@ 형식으로 그대로 파싱하거나 복사해 CMS에 붙여넣으면 됩니다.