AGENTS.md is ignored

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

AGENTS.md is ignored although documentation states it should respect it.
See: AGENTS.md ignored from context · Issue #3693 · cursor/cursor · GitHub

Steps to Reproduce

AGENTS.md placed at the root of the project is not loaded in the context at each new chat.

It is loaded randomly, either when asking directly in the chat to load it or when the tab is already opened, but even though sometimes it’s ignoring the open tab.

Project: react, react-native (both have the same behaviour)
This links with this issue #3650 as Cursor rules in project are as well ignored from context.
Similar as Background agents do not load AGENTS.md

Operating System

MacOS

Current Cursor Version (Menu → About Cursor → Copy)

Version: 2.1.26 (Universal)

Does this stop you from using Cursor

Sometimes - I can sometimes use Cursor

1 Like

same here, recently i find after the latest update, it doesnt follow the AGENTS.MD file

Hey, thanks for the report. There’s a related open issue with auto-loading nested AGENTS.md files (we’re tracking it here: Nested agents.md files not being loaded). It seems like you’re also seeing unpredictable failure to apply even the root AGENTS.md in 2.1.26.

I need details to pass this to the engineers:

  • Project structure (brief tree with paths to AGENTS.md); exact file name and case (AGENTS.md or AGENTS.MD)
  • Reproduction steps + where exactly you create the new chat (root/subfolder)
  • Two Request IDs: one from the chat where AGENTS.md wasn’t picked up, and one where it was (Chat → menu ⋯ → Copy Request ID)
  • Screenshot/video showing that AGENTS.md didn’t appear in the context
  • Logs from Developer Tools (CMD+Shift+P → Toggle Developer Tools → Console tab) when creating the chat
  • If possible—a minimal repro repository

Temporary workaround: explicitly mention @AGENTS.md at the start of the chat or open the file and ask the bot to “add AGENTS.md to the context”.

I’ll link your case to the current investigation.

1 Like