Scan for Project Rules in Subdirectories of .cursor/rules

Feature Requests
1

According to my tests, as of v0.46.11, Cursor does not activate project rules which are stored in sub-directories of the .cursor/rules/ location. See codekiln/cursor-project-rule-test: Testing the Cursor Project Rule feature for an independent repository you can clone and test.

If Cursor did, then we would be able to use Git Submodules to reference Cursor Project Rules stored in a centralized repository, shared among many users and projects. This would unlock a whole new way to share project rules between users and repositories. In my opinion, it’s very important that Cursor enable its community to collaborate together on developing mature, open source cursor rules, and adding this feature would be an important step in that direction.

A number of users in the community have been interested in this functionality; see Mastering Cursor Rules: A Developer’s Guide to Smart AI Integration - DEV Community for an example.

An example of the type of repo that could be pulled in by multiple repositories is GitHub - codekiln/cursor-ai-sdlc: Cursor rules for the phases and stages of the Software Development Life Cycle (SDLC), which proposes a way to use a particular directory to be a bridge between external tools like JIRA and the SDLC.

I’ve listed a number of dynamics and workarounds at CursorAI/How To/Share Cursor Project Rules Across Repositories and Users.

2

0.47 - Changelog - Mar 11, 2025 | Cursor - The AI Code Editor | Cursor - The AI Code Editor, says this is implemented:

  • Rules: Allow nested .cursor/rules directories and improved UX to make it clearer when rules are being applied.
3

Have you found this feature is working for you though? I’m on 0.47.5 and just organized my rules into shared rules for all projects and rules for the specific repo. Now, hovering over the rules toggle in the prompt window only shows rules not in a sub-directory of .cursor/rules

4

Oh nevermind. I was mistaken. The rules toggle is only showing rules that will be auto-attached. I had also set a bunch of rules to always attach, which removes them from that tooltip (but I’m assuming they’re still being used)

5

Yes, it’s working for me! CursorAI/Project Rule/Test/Agent/:white_check_mark:/Find MDC/in Subfolder