Codex app: support local repo-scoped AGENTS instructions for app-created worktrees
Component
Codex app / worktrees / AGENTS.md
Feature Request
Please support repo-scoped local instructions that are private to a developer but automatically available in Codex app-created worktrees.
For example, a repo could have a local-only instructions file such as AGENTS.local.md, or an equivalent app-managed setting, that is loaded alongside AGENTS.md without being committed to git.
Motivation
Some instructions are specific to a repo and a developer’s machine, so they do not belong in committed AGENTS.md, but global Codex instructions are too broad.
Examples:
- setting
KUBECONFIGbefore runningkubectl - copying or linking
.envinto new worktrees - local cluster names, VPN notes, private paths, or machine-specific test setup
Today these either have to be committed, repeated manually, placed in global instructions, or handled partially through setup scripts. None of those quite fit repo-specific private instructions.
Expected Behavior
When the Codex app creates a new worktree for a repo, the repo’s local/private instructions should be available automatically in that worktree’s Codex sessions.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗