Skip to content

feat(codex): add multi-agent integration#234

Closed
YangsonHung wants to merge 1 commit intomsitarzewski:mainfrom
YangsonHung:feat/codex-multi-agent-integration
Closed

feat(codex): add multi-agent integration#234
YangsonHung wants to merge 1 commit intomsitarzewski:mainfrom
YangsonHung:feat/codex-multi-agent-integration

Conversation

@YangsonHung
Copy link
Copy Markdown

What does this PR do?

Adds first-class Codex multi-agent integration for The Agency.

This updates the conversion pipeline to generate Codex-compatible project-scoped role configs under .codex/, adds installer support for Codex projects, and documents the workflow in the main README plus integration docs.

Included

  • scripts/convert.sh --tool codex
  • scripts/install.sh --tool codex
  • generated integrations/codex/config.toml
  • generated integrations/codex/agents/*.toml role files
  • new integrations/codex/README.md
  • README and integrations index updates

Codex-specific behavior

  • Enables [features] multi_agent = true
  • Registers one [agents.<slug>] role per Agency agent
  • Keeps role config minimal by only injecting developer_instructions, so Codex inherits the user's model/sandbox defaults
  • Installs into project-local .codex/
  • Does not overwrite an existing .codex/config.toml; instead writes .codex/agency-agents.snippet.toml for manual merge

Validation

  • bash -n scripts/convert.sh && bash -n scripts/install.sh
  • ./scripts/convert.sh --tool codex
  • ./scripts/convert.sh --tool all
  • parsed generated Codex TOML outputs with Python tomllib
  • tested install.sh --tool codex with and without an existing .codex/config.toml

Agent Information (if adding/modifying an agent)

  • Agent Name: N/A
  • Category: integrations / tooling
  • Specialty: Codex multi-agent conversion and installation

Checklist

  • Follows the agent template structure from CONTRIBUTING.md
  • Includes YAML frontmatter with name, description, color
  • Has concrete code/template examples (for new agents)
  • Tested in real scenarios
  • Proofread and formatted correctly

@msitarzewski
Copy link
Copy Markdown
Owner

Hey @YangsonHung — thank you for the thorough work here, 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 shows how wanted this feature is, but also means we need to consolidate rather than pick one in isolation. One note for the next round: the generated .toml files shouldn't be committed (same policy as Cursor/OpenCode output — users run convert.sh locally).

I'm closing all four Codex PRs and asking everyone to join Discussion #206 to collaborate on a single approach. Your work on the convert/install pipeline changes is great context — please bring it to that thread so we can land this together.

Again, sorry for the delay: #206

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.

2 participants