{
  "id": "page:docs-agent-mux-reference-agents-codex",
  "_kind": "Page",
  "_file": "wiki/docs/agent-mux/reference/agents/codex.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/agent-mux/reference/agents/codex.md",
    "sourceKind": "repo-docs",
    "title": "OpenAI Codex",
    "displayName": "OpenAI Codex",
    "slug": "docs/agent-mux/reference/agents/codex",
    "articlePath": "wiki/docs/agent-mux/reference/agents/codex.md",
    "article": "\n# OpenAI Codex\n\nAdapter for OpenAI's **Codex** CLI.\n\n## Install\n\n```bash\namux install codex\n```\n\nMinimum CLI version: `1.0.0`. Supported on macOS, Linux and Windows.\n\n## Auth\n\n- **API key** only — set `OPENAI_API_KEY` in your environment.\n\nConfig file: `~/.codex/config.json`.\n\n## Minimal run\n\n```bash\namux run codex --prompt \"Write a unit test for utils.ts\"\n```\n\n## Notable flags\n\n- `--model <id>` — default `o4-mini`; `codex-mini-latest` also available.\n- `--full-auto` — emitted when `approvalMode: 'yolo'`.\n- `--quiet <prompt>` — used by the adapter to stream prompt output.\n\n## Session files\n\n- Location: `~/.codex/sessions/*.jsonl`\n- Parsed via the standard JSONL session reader.\n- Resume/fork supported by the adapter layer.\n\n## Plugins\n\nPlugin support: **yes**. Codex has a plugin directory with @plugin-creator skill.\n\n### Plugin Management\n```bash\namux plugin install codex <plugin>\namux plugin list codex\n```\n\n### MCP Servers\n```bash\namux mcp install codex <mcp-server>\namux mcp list codex\n```\n\nRegistry: https://modelcontextprotocol.io for MCP servers.\n\n## Capabilities\n\nThinking models (`o4-mini`) with `low/medium/high` effort levels, tool calling with parallel calls, JSON / structured output, text streaming.\n\n## Known limitations\n\n- No image input/output, no file attachments.\n- No MCP or plugin ecosystem — bring-your-own tooling only.\n- Only two bundled models; other Codex variants must be specified explicitly via `--model`.\n- Project-level config is not supported (`supportsProjectConfig: false`); configuration is global.\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-agent-mux-reference",
      "to": "page:docs-agent-mux-reference-agents-codex",
      "kind": "contains_page"
    }
  ]
}