Skip to main content
Codex is OpenAI’s AI-powered coding agent. It reads custom instructions from AGENTS.md before doing any work, so you can give it project-specific guidance. With Bruno’s local-first approach, you can add an AGENTS.md at your project root so Codex understands how to generate and work with Bruno collections.
Codex discovers instructions in this order: global ~/.codex/AGENTS.md, See Custom instructions with AGENTS.md for full details.

​
Configure Codex with Bruno

  1. Install and set up Codex from the Codex documentation.
  2. At your project root (typically the Git root), create an AGENTS.md file with instructions for working with Bruno collections.
Your project folder structure should look like this:
my-project
codex
AGENTS.md
src
app.js
server.js
package.json
.gitignore
You can write your own instructions in AGENTS.md for Codex to follow when working on Bruno collections, or use the default instructions provided by Bruno if available for Codex.
For example workflows and prompts, see Use cases.