Skip to main content
Codex is a webhook-based integration that lets you send plan tasks to OpenAI Codex for implementation.

​
Setup

  1. Go to Settings in Ref Plans
  2. Click the Agent Settings tab
  3. Select the Webhooks tab
  4. Toggle on Codex

​
How it works

When you send a task to Codex, Ref appends progress-reporting instructions to the task prompt. These instructions include curl commands that Codex uses to report status back to Ref. This means Codex will automatically update your plan with its progress as it works through the task.

​
Cloud environment configuration

If Codex is running in a sandboxed environment with limited network access, make sure to allow outbound requests to: 
https://api.plan.ref.tools

​
Get help

If you have any issues, please reach out to help@ref.tools. We’re happy to help you get started!