AGENTS.md for Codex?

[dhabedank]

Hi Folks! Does anyone have a good AGENTS.md file when working with Codex? The current one which loads upon init, when selecting Codex, uses pretty heavy Claude Code verbiage and doesn't really address the nuances of Codex. Anecdotally it seems like Codex and/or Opencode have a strict adherence to agents.md and because the default file speaks so heavily towards Claude...it gets confused and the MCP encounters errors. Example:

MCP Integration

Task Master provides an MCP server that Claude Code can connect to. Configure in .mcp.json:

{
  "mcpServers": {
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "your_key_here",
        "PERPLEXITY_API_KEY": "your_key_here",
        "OPENAI_API_KEY": "OPENAI_API_KEY_HERE",
        "GOOGLE_API_KEY": "GOOGLE_API_KEY_HERE",
        "XAI_API_KEY": "XAI_API_KEY_HERE",
        "OPENROUTER_API_KEY": "OPENROUTER_API_KEY_HERE",
        "MISTRAL_API_KEY": "MISTRAL_API_KEY_HERE",
        "AZURE_OPENAI_API_KEY": "AZURE_OPENAI_API_KEY_HERE",
        "OLLAMA_API_KEY": "OLLAMA_API_KEY_HERE"
      }
    }
  }
}

Codex uses config.toml as far as I understand. Another example would be:

Tool Allowlist Recommendations

Add to .claude/settings.json:

{
  "allowedTools": [
    "Edit",
    "Bash(task-master *)",
    "Bash(git commit:*)",
    "Bash(git add:*)",
    "Bash(npm run *)",
    "mcp__task_master_ai__*"
  ]
}

I'm not 100% certain on how to adjust these bits which directly leverage model-specific tooling, but I have at least tidy'd things up in the attached version.

AGENTS.md

[Crunchyman-ralph]

Theres this PR that kind of fixes that:
#1326

Wonder if that solves things for you ?

[dhabedank]

Thanks for the heads up on that fix @Crunchyman-ralph! I have noticed a drastic improvement in taskmaster's ability to function using the codex/opencode modified version I posted above. It does seem that the default Claude-centric AGENTS.md can cause high error rates with the MCP when the user is coding with Codex (or perhaps other models and coding tools). I'm thinking #1326 solves for Gemini users, but other models will struggle due to having their own conventions around slash commands, MCP configuration and so forth.

Perhaps taskmaster uses a general AGENTS.md which speaks to the functions of taskmaster. If a user indicates during init that they are using Claude (or Gemini) it will create those custom files instead.

[Crunchyman-ralph]

so we're trying to follow the AGENTS.md convention which is the convention codex follows

[Crunchyman-ralph]

if you look closely into the PR, you'll notice it is improving the AGENTS.md that is good for other agents, and also adding a GEMINI.md that is more specific to the gemini cli