How do I send a task to Codex? | OpenAI | Page 1

brave lotus · 2025-05-23T13:33:58.902Z

I'm trying to use the new model

Hi @brave lotus. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:

To send a task to Codex (the cloud-based software engineering agent), follow these steps:

Connect your repository: First, connect your GitHub repository to Codex by installing the OpenAI GitHub app and authenticating your account. This allows Codex to clone your repo and create pull requests as needed. Each user must authenticate, and access is managed at the ChatGPT workspace level. More details are available in the Codex documentation.
Navigate to Codex: Go to chatgpt.com/codex.
Submit a task: You can submit tasks in two modes:
- Ask mode: For brainstorming, audits, or architecture questions (no code changes).
- Code mode: For automated refactors, tests, or fixes (Codex will modify code and prepare a pull request).
Example prompts:
- Ask mode:
```
Document and create a mermaidjs diagram of the full request flow from the client endpoint to the database.
```
- Code mode:
```
There's a memory-safety vulnerability in <my package>. Find it and fix it.
```
- For code review, you can append .diff to a pull request URL and include it in your prompt.
Codex runs the task: Codex will launch a Docker container, clone your repo, and run the task in its own environment. When finished, it will present a diff or follow-up tasks. You can then choose to open a PR or request further changes.

For more details and example tasks, see the Submit tasks to Codex documentation and the Codex overview.

If you are using the open-source Codex CLI instead, you would run tasks from your terminal using the `codex` command. Let me know if you need instructions for the CLI version!