ezhsergei
October 22, 2025, 1:25am
1
Cursor IDE
docs say that nested agents.md files should be loaded when agents work in those directories, but in my testing they do not every get appended automatically. Only the root agents file is appended automatically.
Link to docs: Rules | Cursor Docs
Have nested agents.md files
Open new agent, ask to make a minor edit to a file deep in the repo.
Ask agent to check what context was loaded automatically.
Agent will respond that only the root agents.md file was loaded.
All Nested agents.md files get loaded automatically if agent makes an edit in a nested directory.
MacOS
Version: 1.7.54
Sometimes - I can sometimes use Cursor
MrWetsnow
October 22, 2025, 12:59pm
2
Cursor IDE
https://cursor.com/docs/context/rules#agentsmd
The AGENTS.md file is not automatically added to the AI chats.
Create an AGENTS.md file. Put any instruction in there. Chat with AI. AI will ignore instructions.
Manually include the file in chat. AI will follow instructions.
AGENTS.md should be included automatically in every agent call.
MacOS
Version: 1.7.54 (Universal)
No - Cursor works, but with this issue
deanrie
October 22, 2025, 4:29pm
3
Hey, thanks for the report. You’re right: nested AGENTS.md files should auto-load when the agent works in those directories.
This looks like a bug in the nested AGENTS.md functionality.
I’ll pass this to the team. As a temporary workaround, you can manually add the nested AGENTS.md files to the agent’s context using @AGENTS.md or by referencing the file directly.
ezhsergei
October 22, 2025, 5:03pm
5
Yeah but that kinda defeats the purpose. I’d suggest updating your documentation to reflect that this functionality is not yet supported.
2 Likes
dfasoro
November 2, 2025, 3:13pm
6
This seems to have been fixed now: Rules | Cursor Docs
pppdns
November 18, 2025, 3:24pm
7
@deanrie Has this been taken care of already, or is it still in progress?
deanrie
November 18, 2025, 3:54pm
8
Hey, the team is working on it.
JoshFerge
December 9, 2025, 7:25pm
9
Hi, any updates on this? Still experiencing this issue. Thank you so much!
eltonio450
December 10, 2025, 8:10am
10
double check that your files is named AGENTS.md (capital letters)
JoshFerge
December 10, 2025, 6:07pm
11
We have, and still observe that nested AGENTS.md are not reliably loaded into context.
system
January 1, 2026, 6:08pm
12
This topic was automatically closed 22 days after the last reply. New replies are no longer allowed.
