cursor# Cursor AI Smart Rules Collection

An extension for Cursor and VS Code that lets you pull .cursorrules files from the awesome-cursorrules repository with multi-selection support.

✨ Features

🎯 Multi-Selection Support: Select multiple rule categories at once using Ctrl/Cmd + click
📁 Organized Structure: Downloads all files to .cursor/rules/[category]/ folder structure
📊 Progress Tracking: Real-time download progress for each rule category
📄 All File Types: Downloads all files from rule folders (.mdc, .cursorrules, README.md, etc.)
⚡ Smart Caching: Caches rule lists for improved performance
🌐 Connection Validation: Checks internet connectivity before attempting downloads
🔄 Background Updates: Updates cache in background for seamless experience

🚀 Usage

Open Command Palette: Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac)
Search for Command: Type "Cursor AI Smart Rules: Add Rules"
Select Rules: Choose one or multiple rule categories (use Ctrl/Cmd + click for multiple selections)
Download: Files will be downloaded to your workspace in .cursor/rules/[category]/ folders
Access Files: Use the downloaded rules in your Cursor/VS Code projects

Demo

📋 Requirements

VS Code version 1.75.0 or higher
Internet connection for downloading rules
An open workspace folder

🛠️ Installation

From VS Code Marketplace

Open VS Code
Go to Extensions view (Ctrl+Shift+X)
Search for "Cursor AI Smart Rules Collection"
Click Install

From VSIX

Download the .vsix file from releases
Open VS Code
Go to Extensions view (Ctrl+Shift+X)
Click the ... menu and select "Install from VSIX..."
Select the downloaded .vsix file

📂 Folder Structure

After downloading rules, your workspace will have the following structure:

your-workspace/
└── .cursor/
    └── rules/
        ├── react/
        │   ├── .cursorrules
        │   └── README.md
        ├── python/
        │   ├── .cursorrules
        │   └── README.md
        └── [other-categories]/
            ├── .cursorrules
            └── [other-files]

🎮 Commands

Command	Description
`Cursor AI Smart Rules: Add Rules`	Opens the rule selector interface

⚙️ Configuration

This extension works out of the box with no configuration required. However, it uses the following:

Cache Duration: 1 hour (rules list is cached for better performance)
Download Location: .cursor/rules/ in your workspace
GitHub API: Uses public GitHub API (no authentication required)

🤝 Contributing

We welcome contributions! Here's how you can help:

Fork the repository
Create a feature branch: git checkout -b feature/your-feature-name
Make your changes and test locally
Commit your changes: git commit -m "Add your feature"
Push to the branch: git push origin feature/your-feature-name
Submit a pull request with a detailed description

Development Setup

# Clone the repository
git clone https://github.com/Pushkar111/cursor-ai-smart-rules.git

# Install dependencies
npm install

# Open in VS Code
code cursor-ai-smart-rules

# Press F5 to launch Extension Development Host

🐛 Known Issues

Large rule categories may take longer to download
Network timeouts may occur on slow connections
Some rule categories might be empty (this is normal)

📝 Release Notes

2.0.0

✨ Complete rewrite with multi-selection support
📁 Organized folder structure (.cursor/rules/[category]/)
📊 Progress tracking for downloads
⚡ Smart caching system
🌐 Connection validation
🔄 Background cache updates
📄 Support for all file types in rule folders

1.0.0

🎉 Initial release
Basic rule downloading functionality

📞 Support

If you encounter any issues or have suggestions:

🐛 Report bugs: Create an issue
💡 Request features: Create a feature request
📧 Contact: pushkarmodi111@gmail.com

🙏 Acknowledgments

Thanks to PatrickJS for maintaining the awesome-cursorrules repository
Thanks to the VS Code team for the excellent extension API
Thanks to the Cursor team for the amazing AI-powered development experience

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Enjoy using Cursor AI Smart Rules Collection! ⭐

If you find this extension helpful, consider:

⭐ Starring the repository
📝 Writing a review on the marketplace
🤝 Contributing to the project
📢 Sharing with fellow developers-smart-rules

Cursor Rules Toolkit

Pushkar Modi