Skip to content

Codex

ChatGPT and Codex are one app. Download the ChatGPT app that includes both, then use Codex for this repo — see ChatGPT.

This repo assumes Codex runs from the repo root that contains Rephrased.uproject, AGENTS.md, and Source/. Codex does not auto-load Cursor .mdc rules, so keep AGENTS.md as the operating index.

First steps

  1. If you are new to the repo as a programmer, read First day (engineering) first.
  2. Download the ChatGPT app that includes Codex and sign in with the account or course token policy your cohort provides.
  3. Open Codex in that app (not the ChatGPT chat pane).
  4. Open Folder on the repo root; confirm Rephrased.uproject appears beside Source/.
  5. Point Codex at team MCP: Rephrased MCP (required). Suggested editor tools: Unreal MCP (port 6388). Codex loads MCP servers only from ~/.codex/config.toml — it does not read the repo's .mcp.json (that feeds Claude Code) or .cursor/mcp.json (Cursor), so run scripts/Onboard-Codex.ps1 and confirm with codex mcp list.

Talk normally. AGENTS.md tells the agent when to call MCP. Do not invent class names, file paths, or UFUNCTION names — search the repo first.

Finish VS and Unreal before relying on Codex for gameplay experiments; Codex never replaces compiling the module.

Change history

  • 2026-09-27 — Gabriel Li — Codex MCP wiring clarified: Codex reads only ~/.codex/config.toml (run scripts/Onboard-Codex.ps1, verify with codex mcp list), not the repo's .mcp.json/.cursor/mcp.json.
  • 2026-08-14 — Gabriel Li — Install via the combined ChatGPT+Codex app; Unreal MCP labeled suggested.
  • 2026-08-13 — Gabriel Li — MCP harness; dropped .agents/skills invoke list.
  • 2026-05-18 — Gabriel Li — Added Codex setup page for AGENTS.md and .agents/skills/ workflow.