feat(codex): add support for codex openai (#153)

dineshSajwan · dinsajwa · Copilot · web-flow · commit e8deca08bdb2 · 2026-04-23T03:36:11.000Z
* feat(codex): add support for codex openai * chore(docs): update README with directory structure information * chore(docs): updated docs Update the note about the AGENTS.md file size limit. * chore(docs): updated markdown syntax * chore(docs) : update the limit messaging Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * chore(docs): update readme Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * feat(codex): add support for codex openai * feat(codex): add support for codex openai * chore(docs) : update the limit messaging Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * feat(codex): add other agents back in readme * chore(doc): apply suggestion from @scottschreckengaust Co-authored-by: Scott Schreckengaust <scottschreckengaust@users.noreply.github.com> * feat(codex): add other agents back in readme * chore(doc): update README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * chore(doc): update README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * feat(codex): updated docs * feat(codex): updated verify set up for codex * merging from main * fix: fix readme.md file * Update README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: dinsajwa <dinsajwa@amazon.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Scott Schreckengaust <scottschreckengaust@users.noreply.github.com> Co-authored-by: Leandro Damascena <lcdama@amazon.pt>
diff --git a/README.md b/README.md
@@ -44,6 +44,7 @@ AI-DLC is an intelligent software development workflow that adapts to your needs
 - [Cline](#cline)
 - [Claude Code](#claude-code)
 - [GitHub Copilot](#github-copilot)
+- [OpenAI Codex](#openai-codex)
 - [Other Agents](#other-agents)
 
 ---
@@ -496,6 +497,64 @@ xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-
 
 ---
 
+### OpenAI Codex
+
+AI-DLC supports OpenAI Codex as a supported coding agent, using the [Codex AGENTS.md](https://developers.openai.com/codex/guides/agents-md) convention to deliver its intelligent workflow. Codex automatically discovers and loads `AGENTS.md` from your project root when you start a session.
+
+The commands below assume you extracted the zip to your `Downloads` folder. If you used a different location, replace `Downloads` with your actual folder path.
+
+**Unix/Linux/macOS:**
+
+```bash
+cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md ./AGENTS.md
+mkdir -p .aidlc-rule-details
+cp -R ~/Downloads/aidlc-rules/aws-aidlc-rule-details/* .aidlc-rule-details/
+```
+
+**Windows PowerShell:**
+
+```powershell
+Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".\AGENTS.md"
+New-Item -ItemType Directory -Force -Path ".aidlc-rule-details"
+Copy-Item "$env:USERPROFILE\Downloads\aidlc-rules\aws-aidlc-rule-details\*" ".aidlc-rule-details\" -Recurse
+```
+
+**Windows CMD:**
+
+```cmd
+copy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rules\core-workflow.md" ".\AGENTS.md"
+mkdir .aidlc-rule-details
+xcopy "%USERPROFILE%\Downloads\aidlc-rules\aws-aidlc-rule-details" ".aidlc-rule-details\" /E /I
+```
+
+**Verify Setup:**
+
+1. Start a Codex session in your project directory
+2. Ask Codex: For existing project - "Using AIDLC analyze the project?" or For new project "Using Aidlc what workflow do you see" .
+3. Codex should describe the AI-DLC three-phase workflow (Inception → Construction → Operations)
+
+> [!NOTE]
+> The `AGENTS.md` file is designed to fit within Codex's instruction budget under default settings. If you add substantial project-specific content and Codex reports that the project documentation exceeds its instruction limit, you can increase the limit in your Codex configuration (for example, by adjusting `project_doc_max_bytes` in your `config.toml` file):
+>
+> ```toml
+> project_doc_max_bytes = 65536  # Example value; choose a limit appropriate for your project
+> ```
+
+**Directory Structure:**
+
+```text
+<my-project>/
+├── AGENTS.md
+└── .aidlc-rule-details/
+    ├── common/
+    ├── inception/
+    ├── construction/
+    ├── extensions/
+    └── operations/
+```
+
+---
+
 ### Other Agents
 
 AI-DLC works with any coding agent that supports project-level rules or steering files. The general approach:
diff --git a/aidlc-rules/aws-aidlc-rules/core-workflow.md b/aidlc-rules/aws-aidlc-rules/core-workflow.md
@@ -13,7 +13,7 @@ The AI model intelligently assesses what stages are needed based on:
 ## MANDATORY: Rule Details Loading
 **CRITICAL**: When performing any phase, you MUST read and use relevant content from rule detail files. Check these paths in order and use the first one that exists, regardless of which IDE or setup method was used:
 - `.aidlc/aidlc-rules/aws-aidlc-rule-details/` (typical with AI-assisted setup)
-- `.aidlc-rule-details/` (typical with Cursor, Cline, Claude Code, GitHub Copilot)
+- `.aidlc-rule-details/` (typical with Cursor, Cline, Claude Code, GitHub Copilot, OpenAI Codex)
 - `.kiro/aws-aidlc-rule-details/` (typical with Kiro IDE and CLI)
 - `.amazonq/aws-aidlc-rule-details/` (typical with Amazon Q Developer)
 
