VSCode extension for managing Cursor AI configuration files with version control.
Features
Initialize and manage .cursorrules and .cursorignore files
Version control for configuration files (keeps last N versions)
Template management with default template support
Built-in default templates for development guide and common ignore patterns
Search and apply rules from awesome-cursorrules repository
Automatic version backup on file changes
Requirements
VSCode 1.84.0 or higher
Git (for rules repository management)
Node.js & npm (for development)
Installation
From VS Code Marketplace:
Open VS Code
Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
Search for "Cursorify"
Click Install
From VSIX file:
Download the .vsix file from the latest release
Run code --install-extension cursorify-x.x.x.vsix
Commands
All commands can be accessed through the Command Palette (Cmd+Shift+P / Ctrl+Shift+P):
Core Commands
Cursorify: Initialize Cursor Configuration
Creates initial .cursorrules and .cursorignore files
Uses default template if set, otherwise creates basic structure
Automatically creates .cursor-history directory for version control
Cursorify: Search Rules
Search for rules based on technology/keywords
Preview rule content before applying
Append selected rules to existing configuration
Template Management
Cursorify: Save Current Rules as Template
Save current .cursorrules or .cursorignore as a reusable template
Add name and description for easy identification
Option to set as default template
Cursorify: Manage Rules Templates
View all saved rules templates
View template content
Set/change default template
Delete templates
Apply template to current project
Cursorify: Manage Ignore Templates
View all saved ignore templates
View template content
Set/change default template
Delete templates
Apply template to current project
Cursorify: Set Default Rules Template
Quick access to set/change default rules template
Option to clear default template
Cursorify: Set Default Ignore Template
Quick access to set/change default ignore template
Option to clear default template
Version Control
Cursorify: Show Configuration History
View version history of configuration files
Each version includes timestamp and version number (v1, v2, etc.)
Cursorify: Rollback Configuration
Restore to a previous version
Automatically creates backup of current version
Cursorify: Show Configuration Diff
Compare different versions of configuration
Visual diff view for easy comparison
Cache Management
Cursorify: Update Rules Cache
Update local cache of rules repository
Shows progress during update
Cursorify: Show Cache Content
View current cache status
Shows cache location and last update time
Cursorify: Clear Cache
Clear local rules cache
Useful for troubleshooting
Configuration
Available settings in VSCode preferences:
cursorify.maxVersions: Maximum number of versions to keep in history (default: 10)
cursorify.defaultRulesTemplate: Default template for new rules configurations
cursorify.defaultIgnoreTemplate: Default template for new ignore configurations
cursorify.savedRulesTemplates: Storage for user-saved rules templates
cursorify.savedIgnoreTemplates: Storage for user-saved ignore templates
cursorify.rulesCache: Cache settings for rules repository
Usage Examples
Initial Setup:
1. Open your project in VSCode
2. Run "Cursorify: Initialize Cursor Configuration"
- Uses built-in default templates if no user defaults are set
- Creates both .cursorrules and .cursorignore files
3. Optionally search for additional rules using "Cursorify: Search Rules"
Managing Templates:
For Rules Templates:
1. Customize your .cursorrules file
2. Run "Cursorify: Save Current Rules as Template"
3. Enter template name and description
4. Optionally set as default rules template
For Ignore Templates:
1. Customize your .cursorignore file
2. Run "Cursorify: Save Current Rules as Template"
3. Choose .cursorignore when prompted
4. Enter template name and description
5. Optionally set as default ignore template
Version Control:
1. Changes to .cursorrules or .cursorignore are automatically versioned
2. Use "Show History" to view versions
3. Use "Rollback" to restore previous versions
4. Use "Show Diff" to compare versions
Adding Rules:
1. Run "Cursorify: Search Rules"
2. Enter technology keywords
3. Preview and select rules to apply
4. Rules are appended to existing configuration
File Structure
your-project/
├── .cursorrules # Main rules configuration
├── .cursorignore # Ignore patterns
└── .cursor-history/ # Version history
├── cursorrules_v1_[timestamp]
├── cursorrules_v2_[timestamp]
└── cursorignore_v1_[timestamp]