ChatGPT Project local AGENTS.md edits can silently diverge from Project UI instructions
Nobody has claimed this yet.
- 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
- Open a Codex task from a ChatGPT Project that has Project instructions.
- Edit the task's local mirror
AGENTS.mdto change a project rule. - Reopen the Project instructions field in the app.
- 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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