Guides/Connecting Codex
DocsGuides

Connecting Codex

OpenAI's coding agent (CLI, IDE extension and app).

New in v0.2.0
$athena agents add codex

Setup for Codex

Run:

bash
athena agents add codex

What Athena configures:

  • Adds the Athena section to AGENTS.md, which Codex reads
  • Registers the Athena MCP server in .codex/config.toml (inside # athena:start / # athena:end markers; the rest of the file is kept)
  • Adds activity hooks in .codex/hooks.json

Note: Codex only loads .codex/ for trusted projects; athena doctor tells you if the project isn't trusted yet.