openai / openai/codex

ChatGPT Project local AGENTS.md edits can silently diverge from Project UI instructions

Open
#45,494 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

app config enhancement
Dominant language
Rust
Stars
125k
Forks
19.4k
PR merge metrics
PR metrics pending

Description

Problem

A Codex task opened from an account-backed ChatGPT Project receives a local mirror containing AGENTS.md and source files. A user or agent can change the local AGENTS.md, but the Project instructions shown in the desktop app's Project settings remain unchanged. The two copies can then disagree. It is easy to assume that editing the visible local instructions updated the Project, especially when the assistant reports that it "updated the instructions."

Steps to reproduce

  1. Open a Codex task from a ChatGPT Project that has Project instructions.
  2. Edit the task's local mirror AGENTS.md to change a project rule.
  3. Reopen the Project instructions field in the app.
  4. Observe that the field still contains the earlier rule.

Actual result

The local file and Project UI remain separate without an obvious in-flow indication of which is authoritative or whether the local edit will carry into future project tasks. This can leave conflicting guidance and cause users to believe a change persisted when it did not.

Expected result

Make the one-way mirror and source of truth clear at the point of editing or reviewing project instructions. For example, label the generated AGENTS.md as a local snapshot, warn when it is modified, and offer a clear path to update the Project instructions field. A two-way update could also solve it if supported, but the main request is to prevent silent divergence.

This is a usability and documentation report, not a claim that the current one-way behavior is an unintended sync bug. No personal project data is included.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing how a Codex task from a ChatGPT Project creates the local AGENTS.md mirror, then inspect the Project instructions field in the desktop app. Compare the local-file and Project settings flows. Done means users can identify the source of truth, recognize a local snapshot, and find a clear path to update Project instructions.

Written by the indexing model from the issue text.

Assessment

Domain
design, desktop, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.