Cursor Rules not working properly in multi root workspace/monorepo

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

.cursor/rules are not found by the agent when using a multi-root workspace (with the root and, for example, a package of the monorepo selected).

When not using multi-root, it works.

Steps to Reproduce

Create a monorepo-like structure (root, packages/packageA, packages/packageB).
Add a .cursor/rules file to the root folder.

Using VS Code’s multi-root workspace (selecting both packageA and root), ask the agent to perform a task in packageA. The rules are not applied.

Expected Behavior

Rules from the root should be applied. Ideally, even without adding the root folder to the multi-root workspace, Cursor should recursively check parent folders for the existence of a .cursor/rules folder.

Currently, there is no solution. Using symlinks in each package completely breaks the context, since Cursor seems to include all rules from the root and its subdirectories by default.

Operating System

MacOS

Current Cursor Version (Menu → About Cursor → Copy)

Version: 1.5.5
VSCode Version: 1.99.3
Commit: 823f58d4f60b795a6aefb9955933f3a2f0331d70
Date: 2025-08-25T17:40:25.290Z
Electron: 34.5.8
Chromium: 132.0.6834.210
Node.js: 20.19.1
V8: 13.2.152.41-electron.0
OS: Darwin arm64 24.6.0

Does this stop you from using Cursor

Yes - Cursor is unusable

Using Cursor rules in a monorepo is a nightmare if you want to work scoped on a package (either by opening Cursor directly on the package folder or by using the multi-root system).

:warning: WARNING: Using symlinks in each package is not a valid workaround and will exponentially increase token consumption.

Hey, checked with the team and this should work already!

We’ve logged this internally to test and fix - thanks for the report :folded_hands:

So you applied a fix ? what is is “working already” ?

What is the correct procedure for working in a monorepo with Cursor rules at the root, without exceeding the context window? @danperks

You pinged the wrong person, I got an email notification and was so confused lol

Is the issue here that you have rules at a project root but are only opening subfolders, and not opening the actual root itself so the rules there don’t get picked up? Is the issue with multi-root or does it also reproduce if you just open a subfolder rather than the project root?

Yes, i only open subfolders when i’m working on monorepo. In multi root (include the root and a subfolder) the behavior seems also broken. It’s not easy to understand also what rules cursor can actually see and use

Could I ask you to try nightly at cursor.com/nightlydownload? I have some fixes in there and wonder if it fixes your case

This topic was automatically closed 22 days after the last reply. New replies are no longer allowed.