Codex app: support local repo-scoped AGENTS instructions for app-created worktrees

Open 💬 3 comments Opened May 5, 2026 by janbernloehr

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 KUBECONFIG before running kubectl
  • copying or linking .env into 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.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗