TL;DR I have published Custom Cursor Rules Multirepo, a Visual Code / Cursor extension to download .cursorrules files from different sources
At the end of last year, I started exploring Cursor more deeply. During that time, I learned a key lesson: the power of defining default instructions for Cursor IDE.
These default instructions can be defined:
- Globally → from the UI:
Cursor Settings>General>Rules for AI. - Per project → by defining a
.cursorrulesfile in the root of the project with the prompt instructions for the UI
Soon I realized there are several places you can get already defined `.cursorrules` to guide the AI into using a specific stack
- At pontusab/cursor.directory there’s a great directory of rules that can be applied to different types of projects
- More Cursor Rules at https://github.com/PatrickJS/awesome-cursorrules (a curated list of awesome
.cursorrulesfiles for enhancing your Cursor AI experience)
So I thought, wouldn’t it be great If I there was a way to download a starter`.cursorrules` for any new project directly from Cursor IDE?
I discovered then the awesome extension Custom Cursor Rules by BeilunYang. This extension allows you to download `.cursorrules` from https://github.com/PatrickJS/awesome-cursorrules.
But the more I used .cursorrules in my projects the more needs I started getting:
- I needed to store my custom
.cursorrules(usuallly customized to my needs from existing ones) so I created my own repo https://github.com/juanma-ai/my-cursor-rules to store them. - I also realized, sometimes I didn’t need a full
.cursorrulesbut some extra instructions that I could add to existing.cursorrules
So I needed an enhanced version of Custom Cursor Rules more adapted to my needs. The quickest way was to fork the project and start playing with it.
At the beginning, with the help of Cursor itself, I created just a personal quick version that allowed me to download cursorrules from two “hardcoded” sites:
That worked well for me for a while. But a few weeks ago, I decided to open this project to more people. To do that I needed to make it more flexible, so with the help of Cursor I added some new features:
- Support for configurable repository sources via `cursorRules.repos` setting
- Repository order in settings determines the order of rules in the Command Palette
"cursorRules.repos": [
"https://github.com/juanma-ai/my-cursor-rules/tree/main/rules",
"https://github.com/PatrickJS/awesome-cursorrules/tree/main/rules",
"https://github.com/tugkanboz/awesome-cursorrules/tree/main/rules"
]
Any repo added to cursorRules.repos must follow the same structure than https://github.com/PatrickJS/awesome-cursorrules/tree/main/rules to organize the rules (e.g: rules/appium-mobile-test-automation-framework/.cursorrules)
- Source indicator in QuickPick UI showing which repository each rule comes from
- User prompt to choose between appending or overwriting
.cursorrulesfile - Enhanced error handling and typescript definitions
Try It Out & Share Your Thoughts!
The Custom Cursor Rules Multirepo extension is now live on the VS Code Marketplace! 🎉 If you work with .cursorrules or want to experiment with AI-powered project guidance, give it a shot and see how it streamlines your workflow.
🔗 Download the extension here.
I’d love to hear your feedback! If you have suggestions, feature requests, or just want to share how you’re using it, feel free to:
- 💬 Comment below
- 🐙 Open an issue on GitHub
- 📢 Spread the word if you find it useful!
Leave a Reply