Skip to content

feat: add codex agent conversion and install support#362

Open
yunuskilicdev wants to merge 1 commit intomsitarzewski:mainfrom
yunuskilicdev:codex/add-codex-integration
Open

feat: add codex agent conversion and install support#362
yunuskilicdev wants to merge 1 commit intomsitarzewski:mainfrom
yunuskilicdev:codex/add-codex-integration

Conversation

@yunuskilicdev
Copy link
Copy Markdown

@yunuskilicdev yunuskilicdev commented Mar 28, 2026

What does this PR do?

Codex is supporting subagents now.
https://developers.openai.com/codex/subagents

Adds Codex support to agency-agents as a standard converted integration.

This change:

  • adds codex to scripts/convert.sh
  • adds codex to scripts/install.sh
  • generates Codex custom agent TOML files under integrations/codex/agents/
  • installs generated Codex agents to ~/.codex/agents/
  • documents Codex usage in the main README, integrations README, and a new integrations/codex/README.md

The Codex mapping is intentionally minimal and keeps the source agents as close to 1:1 as possible:

  • name comes from source frontmatter
  • description comes from source frontmatter
  • developer_instructions contains the source Markdown body

Unsupported source-only metadata such as color, emoji, and vibe is omitted.

The converter also escapes TOML string content safely so existing agents with control characters in the Markdown body do not generate invalid Codex agent files.

Verification

Verified locally by:

  • running ./scripts/convert.sh --tool codex
  • running ./scripts/install.sh --tool codex
  • confirming installed agents were written to ~/.codex/agents/
  • parsing all generated/installed Codex TOML files successfully
  • confirming codex works with the installed custom agents in a live local CLI run

Notes

  • Codex is added as a converted integration, similar to other non-native tool targets in this repo.
  • Generated Codex artifacts are ignored via .gitignore.

Checklist

  • Follows the agent template structure from CONTRIBUTING.md
  • Includes YAML frontmatter with name, description, color
  • Tested in real scenarios
  • Proofread and formatted correctly

@mhc222
Copy link
Copy Markdown

mhc222 commented Mar 30, 2026

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

🤖 Generated with Claude Code

@msitarzewski
Copy link
Copy Markdown
Owner

Hey @yunuskilicdev — good news, we've selected your PR as the Codex integration to move forward with (3 competing PRs closed in favor of yours). Clean code review, well-scoped, and includes the CONTRIBUTING.md update.

One thing needed: the script files have changed significantly since this PR was opened. Could you rebase against current main? The AGENT_DIRS arrays have been reorganized and finance/ was added. Once rebased, we'll merge.

Thanks!

@yunuskilicdev yunuskilicdev force-pushed the codex/add-codex-integration branch from 0fa02ae to 457bf71 Compare April 11, 2026 07:38
@yunuskilicdev
Copy link
Copy Markdown
Author

yunuskilicdev commented Apr 11, 2026

@msitarzewski, Nice to hear that. Rebase from current main is done now.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants