Codex VS Code
Use this skill to make OpenAI Codex follow the repository standards when it runs from VS Code, Cursor, Windsurf, or another VS Code-compatible IDE.
What to Apply
- Prefer
AGENTS.mdas the Codex project instruction file. - Keep Codex instructions short and link to standards files instead of duplicating the whole framework.
- Put
AGENTS.mdat the project root so Codex can auto-discover it for the workspace. - For nested workspaces, check for closer
AGENTS.mdfiles before editing files in subdirectories. - Keep task-specific guidance on-demand through SKILL-REFERENCE.md and skills/.
- When installing this framework into another project, copy
AGENTS.mdtogether with the other root instruction files and rewrite links withscripts/setup.py.
VS Code Notes
- Treat Codex in VS Code as the same coding agent workflow as Codex CLI: it can inspect the repo, edit files, and run checks subject to approvals and sandbox settings.
- Do not use
.instructions.mdfor Codex-specific guidance; that file is for VS Code Copilot. - Use
AGENTS.mdfor shared Codex behavior andPROJECT-STANDARDS.mdfor project-local rules that all agents should honor. - If the user is configuring a VS Code fork, keep the guidance Codex-specific and avoid changing Cursor or Windsurf rules unless the request also affects those tools.
Reference Files
Output Expectation
State which instruction file Codex will load, what changed, and how to verify by asking Codex "What coding standards are you following?"