Codex-specific persistent memory belongs here. Shared conventions and system-wide facts belong in MEMORY.
Use this note for Codex-only behaviours, MCP connector quirks, local CLI details, or workflow state that should not apply to Claude or other agents.
If a Codex MCP connector keeps returning token_expired after codex mcp login <server> succeeds, check for a stale hard-coded authorization header in ~/.codex/config.toml. For the notes connector, remove the old http_headers = { Authorization = "Bearer ..." } line from [mcp_servers.notes] so Codex uses the OAuth credential in ~/.codex/.credentials.json.
The running Codex session may keep an already-open MCP transport with the expired token. Stop and start Codex after removing the stale header or reauthenticating, then verify with a small MCP read such as notes.get README and a key listing.