Render Codex Plugin

Use Render from Codex to deploy apps, validate render.yaml, debug failed deploys, monitor services, and work through common platform workflows.

What you get

• Bundled Render skills for deployment, debugging, monitoring, migrations, and workflows
• OAuth-enabled Render MCP server for Codex, surfaced by the plugin manifest
• Required ChatGPT app mapping for the hosted Render connector
• A helper script at scripts/validate-render-yaml.sh for render blueprints validate
• Plugin metadata and assets for Codex installation

Install the plugin

Install the plugin from the Codex plugin library in the app when it is available there. That is the preferred install path for most users.

Use the local install flow below for development, testing, or pre-release access.

Install locally for development

1. Copy the plugin into ~/.codex/plugins/render:

mkdir -p ~/.codex/plugins
rsync -a ./ ~/.codex/plugins/render/

2. Add the plugin to ~/.agents/plugins/marketplace.json.

If the file already exists, add the render entry to the existing plugins array.

{
  "name": "local-plugins",
  "interface": {
    "displayName": "Local Plugins"
  },
  "plugins": [
    {
      "name": "render",
      "source": {
        "source": "local",
        "path": "./.codex/plugins/render"
      },
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_INSTALL"
      },
      "category": "Developer Tools"
    }
  ]
}

3. Restart Codex.
4. Open the plugin directory in Codex and install Render from your marketplace.

Get started

Use the plugin to:

• Deploy a project to Render
• Validate and troubleshoot render.yaml
• Use Render MCP tools after completing Render OAuth in Codex
• Debug failed deploys and check service status
• Work through common setup and migration tasks

Good first prompts:

• Help me deploy this project to Render.
• Help me validate my render.yaml for Render.
• Debug a failed Render deployment.

Render MCP in Codex

This plugin declares the hosted Render MCP server in .mcp.json with the pre-registered Codex OAuth client id. After installing or updating the plugin, Codex can connect to https://mcp.render.com/mcp and prompt for Render OAuth when MCP tools are first used.

No RENDER_API_KEY or codex mcp add command is needed for the plugin-provided MCP connection. Manual API-key setup is still useful for other AI tools or when using the Render CLI fallback.

ChatGPT app mapping

This plugin also declares the Render ChatGPT app in .app.json so the plugin package can distribute the app mapping with the Render skills. The hosted app backend remains the Render MCP service at https://mcp.render.com/mcp; public ChatGPT availability still follows the normal app review and publishing flow.

Set up the Render CLI

Many Render workflows depend on the Render CLI.

1. Install the Render CLI:

brew install render

2. Authenticate:

render login

3. Verify access:

render whoami -o json

If render whoami -o json fails, fix authentication before you rely on Render workflows in Codex.

For maintainers

Run the sync script to refresh skills/ from render-oss/skills:

./scripts/sync-skills.sh

GitHub Actions also runs .github/workflows/sync-skills.yml each day and opens a pull request when upstream skills change.

License

MIT. See LICENSE.