From github import Project rules bug

Support Bug Reports
1

Describe the Bug

When using imported project rules from GitHub, I noticed that even after a successful import, the rules cannot be retrieved. After consulting the Cursor AI documentation assistant, I found that my configuration is correct.

Steps to Reproduce

When using imported project rules from GitHub, I noticed that even after a successful import, the rules cannot be retrieved. After consulting the Cursor AI documentation assistant, I found that my configuration is correct.

Operating System

MacOS

Current Cursor Version (Menu → About Cursor → Copy)

When using imported project rules from GitHub, I noticed that even after a successful import, the rules cannot be retrieved. After consulting the Cursor AI documentation assistant, I found that my configuration is correct.

For AI issues: which model did you use?

auto

For AI issues: add Request ID with privacy disabled

no

Additional Information

no

Does this stop you from using Cursor

No - Cursor works, but with this issue

2 Likes
Having issues using Cursor Settings to import Remote Rules
Remote rules (via GitHub)
2

Hi everyone,

I’m trying to use Cursor’s remote rules feature, but I’m having trouble getting them to work. I’ve attempted to load remote rules from GitHub, but they don’t seem to be taking effect.

According to Cursor’s official documentation ( Rules | Cursor Docs ), remote rules allow you to host rules on GitHub and add them to your project rules. The documentation does not specify any special requirements for the GitHub repository structure.

I’m not sure about:

- The exact steps to load remote rules from GitHub

- Whether there are special project structure requirements

- If there are any specific configuration needed in the `.cursor/rules/` directory

Has anyone successfully used remote rules? If so, could you share:

- What steps you took to set it up?

- The exact format/structure of the remote rule file?

- Whether there are any special project structure requirements?

- Any specific configuration needed?

I’m wondering if there are certain project requirements or setup steps I might be missing. Any help or guidance would be greatly appreciated!

Thanks!

2 Likes
3

i also want to know ，cause i have a same question

4

I’ve add remote rules from a github repo, but it seems that the remote rules didn’t work. How can I see the remote rules in my project? Thanks.

5

i have the same bug

6

Hey, thanks for the report. I’ll pass it to the team.

8

yes the bug happened to me

9

Same here. Remote rule was added, but can’t see it anywhere. If I want to add it again, it says this is already imported.

Version: 2.2.20
VSCode Version: 1.105.1
Commit: b3573281c4775bfc6bba466bf6563d3d498d1070
Date: 2025-12-12T06:29:26.017Z
Electron: 37.7.0
Chromium: 138.0.7204.251
Node.js: 22.20.0
V8: 13.8.258.32-electron.0
OS: Darwin arm64 25.1.0

10

The remote rules are saves here

<home>/.cursor/projects/<project_name>/rules/<github_repo_name>/
11

Hi ,did bug fixed？

12

Thanks for the ping. The issue still reproduces - this is a known problem, the team is working on a fix.

13

It seems that this bug has been fixed in 2.2.30. But the rules are not auto updated with the repo. Also, there’s no any convinience way to remove the rule.

14

Appears to be still broken as of 2.2.44

15

@deanrie Hello the bug seem appeared again！

16

Hey, thanks for the ping. I can see the bug is back, the team is aware and is working on a fix.

To help with debugging, can you share:

  • Your current Cursor version (Menu → About Cursor → Copy)
  • Which specific rules you’re importing (link to the GitHub repo)
  • Are you able to find the cloned rule files anywhere in the .cursor directory?
17

1.Version: 2.2.44 (Universal)
2.GitHub - timqin-m/zion-aicoding-rules: 用于给到AI Coding工具接入Zion后端构建全栈应用的详细规则
3. yep in .cursor/{project.Name}/rules

18

Thanks for the info. I can confirm this is a known issue, and the team is working on a fix. The bug is tracked and currently being worked on.

The files are imported correctly (I can see they’re in .cursor/{project}/rules), but Cursor isn’t picking them up for use.

I’ll keep you posted as soon as there’s an update on this bug.

1 Like
19

thanks

20

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