Explore Lessons AI Updates Blog About

Log in For Teams Start for Free

Learn AI by doing.

Start for Free For Teams About FAQ Updates Blog

Sign Up Sign In Support

2026 Moonswell Marketing LLC·Terms·Privacy··

Codex Multi-Folder Projects | OpenAI | Chasing Next

OpenAIfeature

July 23, 2026·Source

Codex Multi-Folder Projects

A local Codex project can now span multiple folders, so Codex reads and writes across related code and docs while one folder stays the Git root.

Details

A local project can include related code, docs, and reference files from multiple folders, and Codex can read and write across all of them.
One primary folder stays the Git root and handles Git operations, review, and pull requests.
The primary folder is also where Codex looks for AGENTS.md and discovers skills.

Best for

Working in a Codex project that pulls in code, docs, and reference files spread across separate folders.

When to use it

Your related files live in more than one directory and you want Codex to see all of them at once.

Who benefits

Developers using local Codex projects.

More from OpenAI

Health in ChatGPT

ChatGPT Voice in the Desktop App

OpenAI Presence

Staying informed is great. Staying ahead is better.

Pick a topic and leave with something you created.

Start for Free Bring to Your Team

Get new module drops and weekly AI strategy.