Skip to content

Conversation

fahadkhan1740
Copy link

@fahadkhan1740 fahadkhan1740 commented Sep 14, 2025

Summary: Adds first-class Codex support as both MCP client and Agent.

  • Detects Codex via system command and project markers.
  • Installs MCP server config to .codex/mcp.json and guidelines to .codex/guidelines.md.
  • Enables frontmatter for guidelines to improve application in Codex.
  • Enables frontmatter for guidelines to improve application in Codex.

Changes:

  • New: src/Install/CodeEnvironment/Codex.php
  • Register: src/Install/CodeEnvironmentsDetector.php (added codex)
  • Docs: README Codex sections (Installation + Manual MCP)
  • Script: composer mcp alias for local MCP server
  • Tests: tests/Feature/Install/CodeEnvironment/CodexTest.php, detector tests for Codex, fixture tests/fixtures/codex-mcp.json

Detection details:

  • System: which codex (Darwin/Linux), where codex (Windows)
  • Project: .codex/, .codex/mcp.json, .codex/config.json
  • Env overrides:
  • CODEX_HOME${CODEX_HOME}/.codex
  • CODEX_CONFIG_DIR${dir}/mcp.json, ${dir}/config.json

@DigitalEntelechy
Copy link

How did you get Codex working without this? I'm stumped.

@pushpak1300
Copy link
Member

pushpak1300 commented Sep 15, 2025

@fahadkhan1740 could you clarify where the config files are actually supported in Codex right now? The docs only mention agents.md and ~/codex/config.toml.

@pushpak1300 pushpak1300 marked this pull request as draft September 16, 2025 20:34
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