README.md

# OpenAI Developers Plugin

This plugin is the Codex-facing bundle for OpenAI developer workflows. It pairs OpenAI Platform workflows with Codex's native OpenAI docs skill guidance so users can build AI applications and agents, then connect those projects to `platform.openai.com`.

## What Is Included

- `.codex-plugin/plugin.json` declares the Codex plugin metadata and user-facing `OpenAI Developers` brand.
- `.app.json` exposes the `openai-platform` app connector used to work with the OpenAI Platform.
- `.mcp.json` connects the optional API-credit promo backend using the current ChatGPT session. `mcp/server.mjs` provides native API-key setup choices, local destination confirmation, and organization selection before claim arguments are returned.
- `skills/setup/` guides post-install API-key setup, optional credit claiming, and a first Responses API request. Canceling organization selection skips claiming and lets API setup continue.
- `skills/openai-platform-api-key/` handles encrypted API-key creation and local project setup; its preferred flow uses the OpenAI Platform connector-owned picker for the key name, organization, and project, then requests local confirmation of the env-file destination before writing locally.
- `skills/openai-api-migration/` audits existing AI integrations and applies agreed migrations to OpenAI or Responses API best practices while preserving application behavior.
- `skills/openai-api-troubleshooting/` classifies common runtime API failures and routes users to the right next step.
- `skills/devday-guide/` answers DevDay questions and helps plan sessions using official public sources, with a bundled 2026 attendee reference for onsite logistics. It complements the existing sidebar without adding another agenda, notes, or tools to read or change saved sessions.
- `skills/openai-computer-use/` helps build and verify browser or desktop automation with OpenAI SDK tools.
- `assets/logo.png` is intentionally shared by both the plugin tile and the bundled OpenAI Platform app tile.
- `skills/agents/` builds and verifies Agents API apps with OpenAI-hosted sandboxes by default, and supports self-hosted sandboxes and Agents SDK workflows when requested. It replaces the `agents-sdk` skill; invoke it as `$agents`. Agents API use requires project access.

## Local Validation

The local promo form returns claim arguments after organization selection; the remote `link_api_org` API retains ownership and SSO enforcement.

Run these commands from `chatgpt/oai-maintained-plugins`:

```bash
node --test plugins/openai-developers/tests/*.test.mjs
cloud-plugin-admin validate-plugin-for-release plugins/openai-developers
cloud-plugin-admin catalog validate marketplace.json
```