Skip to content

Add Codex runtime support and dual-runtime migration path#2

Open
kwehden wants to merge 2 commits intojamesnordlund:mainfrom
kwehden:feat/codex-dual-runtime-port
Open

Add Codex runtime support and dual-runtime migration path#2
kwehden wants to merge 2 commits intojamesnordlund:mainfrom
kwehden:feat/codex-dual-runtime-port

Conversation

@kwehden
Copy link

@kwehden kwehden commented Mar 3, 2026

Summary

This PR ports System2 to support Codex as a first-class runtime while preserving existing Claude plugin behavior.

What Changed

  • Added a Codex runtime pack under codex/:
    • codex/manifest.json
    • codex/runtime/agent-registry.json
    • codex/templates/AGENTS.md
    • codex/skills/init/SKILL.md (system2-init)
    • codex/tools/validate_paths.py
    • codex/install.sh
    • codex/config.toml.example
    • codex/README.md
  • Updated README.md for dual runtime support (Claude + Codex), including Codex installation and update flow.
  • Added migration guide for existing Claude-only teams:
    • docs/MIGRATION_CLAUDE_TO_DUAL_RUNTIME.md
  • Added Codex-specific eval harness + goldens:
    • evals/run_codex_evals.py
    • evals/goldens/codex_manifest_schema.json
    • evals/goldens/codex_required_readme_patterns.json
    • evals/goldens/codex_template_sections.json
  • Updated CHANGELOG.md (Unreleased) with Codex runtime + migration documentation changes.

Installer Behavior

  • codex/install.sh now enables Codex multi-agent mode as part of install:
    • runs codex features enable multi_agent

Validation

  • python3 evals/run_evals.py → 27 passed, 0 failed
  • python3 evals/run_codex_evals.py → 8 passed, 0 failed

Compatibility Notes

  • Claude plugin runtime remains unchanged.
  • Codex runtime is additive and can be rolled out incrementally.

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.

1 participant