🚀 Cursor Rules Toolkit

Extension for Cursor IDE & VS Code - AI Rules Management

Transform your AI-powered development workflow with the ultimate toolkit for managing Cursor AI rules. Seamlessly integrate hundreds of curated Cursor Rule files from the industry-leading awesome-cursorrules repository directly into your workspace.

✨ Production-Grade Features

🎯 Enterprise-Ready Multi-Selection: Batch download multiple rule categories with a single command
📁 Intelligent Auto-Organization: Automatically structures rules in .cursor/rules/ for optimal workspace management
⚡ Real-Time Progress Tracking: Advanced progress indicators with detailed status updates
🚄 High-Performance Caching: Lightning-fast rule loading with intelligent background refresh
🔄 Auto-Update System: Keeps your rule library current with zero maintenance
🛡️ Error-Resilient Architecture: Robust error handling for production environments
📊 Workspace Analytics: Smart detection and organization of project-specific rules
🔧 Universal Compatibility: Works seamlessly in both Cursor IDE and VS Code

🚀 Cross-Platform Installation Guide

💻 Cursor IDE Installation

🪟 Windows (Cursor IDE)

# Method 1: Cursor Extensions Panel (Recommended)
# Open Cursor IDE → Extensions (Ctrl+Shift+X) → Search "Cursor Rules Toolkit"

# Method 2: Command Line
cursor --install-extension YorkIE.cursor-rules-toolkit

# Method 3: Manual Installation
# Download .vsix file and install via Extensions panel

🍎 macOS (Cursor IDE)

# Method 1: Cursor Extensions Panel (Recommended)
# Open Cursor IDE → Extensions (Cmd+Shift+X) → Search "Cursor Rules Toolkit"

# Method 2: Terminal Installation
/Applications/Cursor.app/Contents/Resources/app/bin/cursor --install-extension YorkIE.cursor-rules-toolkit

# Method 3: Homebrew (if Cursor installed via Homebrew)
cursor --install-extension YorkIE.cursor-rules-toolkit

🐧 Ubuntu/Linux (Cursor IDE)

# Method 1: Cursor Extensions Panel (Recommended)
# Open Cursor IDE → Extensions (Ctrl+Shift+X) → Search "Cursor Rules Toolkit"

# Method 2: Terminal Installation
cursor --install-extension YorkIE.cursor-rules-toolkit

# Method 3: AppImage Installation
./Cursor-*.AppImage --install-extension YorkIE.cursor-rules-toolkit

# Method 4: Debian/Ubuntu Package
sudo dpkg -i cursor_*.deb
cursor --install-extension YorkIE.cursor-rules-toolkit

📝 VS Code Installation

🪟 Windows (VS Code)

# Method 1: VS Code Marketplace (Recommended)
ext install YorkIE.cursor-rules-toolkit

# Method 2: Command Line
code --install-extension YorkIE.cursor-rules-toolkit

# Method 3: PowerShell with Admin Rights
Start-Process powershell -Verb runAs
code --install-extension YorkIE.cursor-rules-toolkit

🍎 macOS (VS Code)

# Method 1: VS Code Marketplace (Recommended)
ext install YorkIE.cursor-rules-toolkit

# Method 2: Terminal Installation
code --install-extension YorkIE.cursor-rules-toolkit

# Method 3: Homebrew Installation
brew install --cask visual-studio-code
code --install-extension YorkIE.cursor-rules-toolkit

🐧 Ubuntu/Linux (VS Code)

# Method 1: VS Code Marketplace (Recommended)
ext install YorkIE.cursor-rules-toolkit

# Method 2: APT Package Manager (if VS Code installed via APT)
code --install-extension YorkIE.cursor-rules-toolkit

# Method 3: Snap Installation (if VS Code installed via Snap)
snap run code --install-extension YorkIE.cursor-rules-toolkit

# Method 4: Manual Installation
wget https://marketplace.visualstudio.com/_apis/public/gallery/publishers/YorkIE/vsextensions/cursor-rules-toolkit/latest/vspackage -O cursor-rules-toolkit.vsix
code --install-extension cursor-rules-toolkit.vsix

🎮 Universal Keyboard Shortcuts

Cursor IDE Shortcuts

VS Code Shortcuts

🚀 Power User Workflow

For Cursor IDE Users

1. 🎯 Launch Command:

   • Windows/Linux: Ctrl+Shift+P → Cursor Rules: Add Rules
   • macOS: Cmd+Shift+P → Cursor Rules: Add Rules

2. 📋 Multi-Select: Choose from 50+ curated rule categories optimized for Cursor AI

3. 🔄 Auto-Deploy: Rules are instantly organized in your workspace

4. 🤖 AI Integration: Leverage enhanced Cursor AI with specialized rules

5. 💻 Start Coding: Experience next-level AI-powered development

For VS Code Users

1. 🎯 Launch Command:

   • Windows/Linux: Ctrl+Shift+P → Cursor Rules: Add Rules
   • macOS: Cmd+Shift+P → Cursor Rules: Add Rules

2. 📋 Multi-Select: Choose from 50+ curated rule categories

3. 🔄 Auto-Deploy: Rules are instantly organized in your workspace

4. 💻 Start Coding: Leverage AI-powered development immediately

🎯 Why Choose Cursor Rules Toolkit?

🏢 Production-Ready Architecture

• Built for enterprise development teams
• Cross-platform compatibility (Windows, macOS, Linux)
• Universal support for both Cursor IDE and VS Code
• Scalable architecture supporting thousands of rules

🛠️ Developer Experience First

• Zero configuration required - works out of the box
• Intuitive UI with smart defaults
• Seamless integration with existing Cursor and VS Code workflows
• Native performance on all operating systems and IDEs

🔒 Enterprise Security

• No sensitive data collection
• Offline-capable after initial download
• Secure HTTPS connections only
• Compliant with enterprise security policies

📋 System Requirements

Minimum Requirements

Recommended for Optimal Performance

🏗️ Intelligent Workspace Structure

The extension creates a production-optimized directory structure across all platforms and IDEs:

🪟 Windows Structure (Cursor IDE & VS Code)

📁 C:\Users\YourName\Projects\your-project\
├── 📁 .cursor\
│   └── 📁 rules\
│       ├── 📁 react-typescript\
│       │   ├── 📄 .cursorrules
│       │   └── 📄 README.md
│       └── 📁 python-fastapi\
│           ├── 📄 .cursorrules
│           └── 📄 documentation.md
├── 📁 src\
└── 📄 package.json

🍎 macOS Structure (Cursor IDE & VS Code)

📁 /Users/YourName/Projects/your-project/
├── 📁 .cursor/
│   └── 📁 rules/
│       ├── 📁 react-typescript/
│       │   ├── 📄 .cursorrules
│       │   └── 📄 README.md
│       └── 📁 python-fastapi/
│           ├── 📄 .cursorrules
│           └── 📄 documentation.md
├── 📁 src/
└── 📄 package.json

🐧 Linux Structure (Cursor IDE & VS Code)

📁 /home/username/projects/your-project/
├── 📁 .cursor/
│   └── 📁 rules/
│       ├── 📁 react-typescript/
│       │   ├── 📄 .cursorrules
│       │   └── 📄 README.md
│       └── 📁 docker-optimization/
│           ├── 📄 .cursorrules
│           └── 📄 best-practices.md
├── 📁 src/
└── 📄 package.json

🆘 Support & Community

Platform-Specific Support

• 🪟 Windows: Windows Issues
• 🍎 macOS: macOS Issues
• 🐧 Linux: Linux Issues

IDE-Specific Support

• 🎯 Cursor IDE: Cursor Issues
• 📝 VS Code: VS Code Issues

Need Help?

• 📧 Enterprise Support: support@york.ie
• 💬 Community Discord: Join our community
• 🐛 Bug Reports: GitHub Issues
• 💡 Feature Requests: GitHub Discussions

📄 License

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

🙏 Acknowledgments & Credits

• Pushkar Modi - York IE Intern 2025-26 batch
• Parth Raninga - York IE Intern 2025-26 batch
• Vishal Prajapati - York IE Intern 2025-26 batch
• Patrick JS - Creator of the awesome-cursorrules repository
• Cursor Team - For revolutionizing AI-powered development
• VS Code Team - For the exceptional extensibility platform