Add Codex AGENTS.md integration

[stablegenius49]

Summary\n- add a target to

The Agency -- Converting agents to tool-specific formats
Repo: /Users/frank-mac-mini/.openclaw/workspace/repos/agency-agents
Output: /Users/frank-mac-mini/.openclaw/workspace/repos/agency-agents/integrations
Tool: all
Date: 2026-03-12

Converting: antigravity
[OK] Converted 120 agents for antigravity

Converting: gemini-cli
[OK] Wrote gemini-extension.json
[OK] Converted 120 agents for gemini-cli

Converting: opencode
[OK] Converted 120 agents for opencode

Converting: cursor
[OK] Converted 120 agents for cursor

Converting: codex
[OK] Converted 120 agents for codex

Converting: aider
[OK] Converted 120 agents for aider

Converting: windsurf
[OK] Converted 120 agents for windsurf

Converting: openclaw
[OK] Converted 120 agents for openclaw
[OK] Wrote integrations/codex/AGENTS.md
[OK] Wrote integrations/aider/CONVENTIONS.md
[OK] Wrote integrations/windsurf/.windsurfrules

[OK] Done. Total conversions: 960 that generates \n- add

The Agency -- Installing agents
Repo: /Users/frank-mac-mini/.openclaw/workspace/repos/agency-agents
Installing: codex

[OK] Codex: installed -> /Users/frank-mac-mini/.openclaw/workspace/repos/agency-agents/AGENTS.md
[!!] Codex: project-scoped. Run from your project root to install there.

+------------------------------------------------+
| Done! Installed 1 tool(s). |
+------------------------------------------------+

Run ./scripts/convert.sh to regenerate after adding or editing agents. to install the generated into a project root\n- document Codex alongside the other supported integrations\n\n## Verification\n- \n- \n-
The Agency -- Converting agents to tool-specific formats
Repo: /Users/frank-mac-mini/.openclaw/workspace/repos/agency-agents
Output: /Users/frank-mac-mini/.openclaw/workspace/repos/agency-agents/integrations
Tool: codex
Date: 2026-03-12

Converting: codex
[OK] Converted 120 agents for codex
[OK] Wrote integrations/codex/AGENTS.md
[OK] Wrote integrations/aider/CONVENTIONS.md
[OK] Wrote integrations/windsurf/.windsurfrules

[OK] Done. Total conversions: 120\n- install smoke test in a temporary project directory (

The Agency -- Installing agents
Repo: /Users/frank-mac-mini/.openclaw/workspace/repos/agency-agents
Installing: codex

[!!] Codex: AGENTS.md already exists at /Users/frank-mac-mini/.openclaw/workspace/repos/agency-agents/AGENTS.md (remove to reinstall).

+------------------------------------------------+
| Done! Installed 1 tool(s). |
+------------------------------------------------+

Run ./scripts/convert.sh to regenerate after adding or editing agents.)\n\nFixes #144.

[msitarzewski]

Hey @stablegenius49 — nice Codex integration! The convert.sh and install.sh changes look solid and follow existing patterns.

One thing needs fixing before we can merge: the integrations/codex/AGENTS.md file (29k lines) is committed. Our policy is that all generated integration files are gitignored — users run convert.sh locally to generate them. See CONTRIBUTING.md for details.

Please:

1. Remove integrations/codex/AGENTS.md from the PR
2. Add integrations/codex/AGENTS.md to .gitignore
3. Keep the integrations/codex/README.md — that's fine to commit

Once that's done we're good to merge!

[stablegenius49]

Fixed.

• removed the generated integrations/codex/AGENTS.md from the PR
• gitignored integrations/codex/AGENTS.md so future generated output stays local
• kept integrations/codex/README.md committed as requested

[msitarzewski]

Hey @stablegenius49 — the AGENTS.md fix looks good, thanks for that.

Before we can merge, the PR needs a rebase against current main. A few things have landed since you branched:

1. Fix convert.sh single-file output cross-contamination #186 refactored write_single_file_outputs() — each format now has its own if block gated on --tool. Your Codex block should follow that pattern:

   if [[ "$tool" == "all" || "$tool" == "codex" ]]; then
     mkdir -p "$OUT_DIR/codex"
     cp "$CODEX_TMP" "$OUT_DIR/codex/AGENTS.md"
     info "Wrote integrations/codex/AGENTS.md"
   fi

2. Qwen Code was added as a tool — so tool lists, ALL_TOOLS, valid_tools, tools_to_run, and the interactive selector numbering need to account for it (you'll see it when you rebase).

Once you rebase and resolve those conflicts, this is ready to go.

[VictorSesma]

awww, so looking forward for this. thanks a lot @stablegenius49 ! Would love to see this working in codex too!

[msitarzewski]

Hey @stablegenius49 — thank you for working on this, and I'm sorry it sat so long without a proper response. That's on me.

It turns out four separate PRs came in for Codex integration (#160, #234, #293, #322) — which is a testament to how wanted this feature is, but also means we need to consolidate rather than pick one in isolation.

I'm closing all four Codex PRs and asking everyone to join Discussion #206 to collaborate on a single approach. Your work here is valuable context — please bring your ideas and findings to that thread so we can land this together.

Again, sorry for the delay. Let's get this right as a group: #206