CursorToys

A powerful collection of utilities that transform Cursor AI into a collaborative productivity powerhouse.

Installation · Utilities · Quick Start · What's New

🔨 Utilities

CursorToys includes over 9 utility categories to optimize your Cursor AI workflow:

🎯 Smart Recommendations

Discover relevant tools for your project — AI-powered suggestions analyzing your tech stack.

• 🔍 Auto-Detection — Analyzes project languages, frameworks, and context
• 🎨 Marketplace Browser — Elegant interface to browse and install recommendations
• 🏷️ Tag-Based Search — Find commands, prompts, and rules by tags or description
• 📦 Bundle Support — Install multiple items at once
• 🌐 Official Index — Curated recommendations included (customizable)
• 📝 YAML Metadata — Frontmatter support for better organization
• ⚡ Smart Caching — Fast performance with memory and disk caching

Supported Contexts:

• Languages: JavaScript, TypeScript, Python, Java, Go, Rust, Ruby, PHP, Elixir
• Frameworks: React, Next.js, Vue, Angular, Svelte, Express, NestJS
• Tools: Jest, Vitest, Playwright, Cypress, Docker, Kubernetes, Terraform

🔗 Instant Sharing

Share AI configurations with one click — No screenshots or copy-pasting.

• 🎯 One-Click Links — Convert commands, rules, and prompts to deeplinks or CursorToys format
• ⌨️ Fast Import — Cmd+Shift+I to import from any link
• 🔄 Multiple Formats — Deeplink, web URL, CursorToys compressed format, or GitHub Gist
• 👥 Team Sync — Everyone uses the same AI instructions
• 📦 CursorToys Format — New compressed format ideal for large files (no URL length limits)

🌐 In-Editor API Testing

Test APIs without leaving Cursor — Full REST client built-in.

• 🚀 Execute Requests — Run HTTP requests from .req files with CodeLens
• 📝 Multiple Formats — cURL commands or REST Client format (METHOD URL)
• ⚡ Performance Tracking — See execution time for each request
• 🎨 Syntax Highlighting — Beautiful highlighting for requests and responses
• 🌍 Environment Variables — Use {{variableName}} from .env files
• 🔧 Inline Variables — Define variables with # @var VAR_NAME=value directly in files
• 🎯 Helper Functions — Dynamic values: {{@uuid()}}, {{@datetime}}, {{@randomIn()}}, {{@prompt()}}
• 🔄 Multiple Environments — Switch between dev, staging, prod instantly
• 💾 Auto-Save Responses — Or preview-only mode for quick tests

📚 Personal Libraries

Build reusable libraries — Commands that work across all projects.

• 🗂️ Visual Tree View — Browse all personal commands and prompts in Explorer sidebar
• 🏠 Personal + Project — Separate libraries for personal and project-specific
• ✏️ Easy Management — Rename, delete, reveal in folder
• 🔍 Smart Filtering — Filter by file extensions
• 📂 Hierarchical Folders — Organize in subfolders with drag-and-drop
• 🎯 Drag & Drop — Move commands/prompts between folders easily

📓 Project Notepads

Build project-specific documentation — Notepads that stay with your project.

• 📝 Project Notepads — Workspace-specific markdown notes in .cursor/notepads/
• 🗂️ Visual Tree View — Browse and manage notepads in Explorer sidebar
• 📂 Hierarchical Organization — Organize notepads in subfolders with drag-and-drop
• ✏️ Easy Management — Create, rename, delete, and reveal notepads
• 🔗 Shareable — Generate CursorToys shareables or Gist for individual notepads or entire folders
• 🎯 Drag & Drop — Move notepads between folders easily
• 🔄 Auto-Refresh — File system watchers keep tree view in sync

🪝 Cursor Hooks

Manage Cursor hooks configuration — Automate workflows with hooks.

• 📄 Hooks Management — Visual interface for managing hooks.json files
• 🏠 Personal + Project — Separate hooks for personal (all projects) and project-specific
• 🗂️ Visual Tree View — Browse hooks and associated scripts in Explorer sidebar
• ✏️ Easy Management — Create, share, delete, reveal hooks files
• 🔗 Shareable — Share hooks via CursorToys format or GitHub Gist
• 📝 Script Detection — Automatically detects and displays hook scripts
• 🎯 Context Menu — Right-click actions for all hook operations

🗜️ File Minification

Optimize files and clipboard content — Reduce file sizes instantly.

• 📦 Minify Files — One-click minification for JSON, HTML, XML, CSS, SVG, JS, TS
• 📋 Clipboard Minification — Minify clipboard content with auto-detection
• 📊 Statistics — See original size, minified size, and savings percentage
• ⚙️ Configurable — Customize output suffix and behavior
• 🎯 Context Menu — Right-click any supported file → Minify File

💬 Chat Integration

Send code to Cursor AI faster — No manual copy-paste.

• ✂️ Send Selection — Right-click → Send to Chat
• 🔗 Prompt Deeplinks — Generate shareable prompt links from selected code
• 📝 Custom Text — Send any text directly to chat
• 📍 Context Included — File path, language, and line numbers auto-added

🌐 GitHub Gist Integration

Share via GitHub Gist — Maximum compatibility, discoverability, and browser viewing.

• ✅ Browser Viewing — Recipients can view without importing
• ✅ Maximum Compatibility — Works with any editor, not just Cursor
• ✅ Public or Private — Control visibility of shared content
• ✅ Permanent Links — Gists stay accessible on GitHub
• ✅ Version History — GitHub tracks gist changes
• ✅ Embedded Viewing — Gists can be embedded in docs

📋 Installation

For detailed installation instructions and system requirements, visit the complete documentation.

But to get started quickly, choose one of the installation methods below:

git clone https://github.com/CursorToys/cursor-toys.git
cd cursor-toys
npm install
npm run compile
npm run package

🚀 Quick Start

Get Started in 60 Seconds

Step 1: Test an API (30 seconds)

# Create .cursor/http/api-test.req in your project
curl -X GET https://api.github.com/users/octocat

Click the "Send Request" link that appears above → See formatted response!

Step 2: Share a Command (20 seconds)

1. Create .cursor/commands/my-command.md
2. Right-click → "Generate Cursor Toys Command"
3. Link copied! Share it anywhere.

Step 3: Import Team Config (10 seconds)

1. Press Cmd+Shift+I (Mac) or Ctrl+Shift+I (Windows/Linux)
2. Paste a deeplink
3. Done! File created automatically.

Main Commands

Pro Tip: Most commands are accessible via CodeLens (clickable links in your files) or context menu (right-click)!

✨ What's New

Version 1.5.0 (January 2026)

For a detailed look at the latest changes, visit the CHANGELOG.

✨ Highlights

• ✅ Cursor Hooks Management — Complete hooks.json management system
• ✅ Smart Recommendations — Complete recommendation system based on project context
• ✅ Marketplace Browser — Elegant visual interface to explore recommendations
• ✅ Project Notepads — Project-specific markdown documentation in .cursor/notepads/
• ✅ GitHub Gist Integration — Share via Gist for maximum compatibility
• ✅ HTTP Environments — Environment variables for HTTP requests
• ✅ Advanced Minification — Support for JSON, HTML, XML, CSS, SVG, JS, TS
• ✅ Clipboard Processing — Smart clipboard minification

Cursor Hooks Management

• Visual tree view for hooks.json files (personal and project)
• Create, share, and manage hooks configurations
• Automatic detection of hook scripts
• Share hooks via CursorToys or GitHub Gist
• Import hooks with Cmd+Shift+I

Smart Recommendations System

• Context-based recommendation system for projects
• Automatic detection of languages, frameworks, and tools
• Marketplace browser with elegant visual interface
• Support for tags, descriptions, and YAML frontmatter
• Smart caching for performance
• Official marketplace at CursorToys/marketplace (contributions via PR)

Project Notepads

• Project notepads in .cursor/notepads/
• Tree view visualization in sidebar
• Hierarchical organization with drag-and-drop
• Sharing via CursorToys or GitHub Gist
• Bundle support (share entire folders)

GitHub Gist Integration

• Sharing via GitHub Gist for maximum compatibility
• Browser viewing without importing
• Support for public and private gists
• Automatic gist import
• Embedded metadata for validation

HTTP Environments

• Environment variables in .cursor/http/environments/
• Support for multiple environments (dev, staging, prod)
• {{variableName}} syntax for dynamic values
• Fast switching between environments
• Validation of unresolved variables

File Minification

• Minification of JSON, HTML, XML, CSS, SVG, JS, TS
• Clipboard minification with auto-detection
• Detailed savings statistics
• Configurable output suffix
• Context menu and editor title bar

General Improvements

• Performance improvements in cache system
• Bug fixes and stability
• Expanded and improved documentation
• Better VS Code support

🛣️ Roadmap

We are planning some nice new features and improvements for the next releases:

• 🎨 Command Templates — Library of ready-to-use templates
• 🔄 Cloud Sync — Synchronize personal libraries via cloud
• 📊 Usage Analytics — See which commands you use most
• 🎯 AI Command Builder — Create commands with AI assistance
• 🌐 Public Marketplace — Share and discover community commands
• 📱 Mobile Preview — View HTTP responses in different screen sizes

❤️ CursorToys Community

The CursorToys team is extremely grateful to have the support of an amazing active community. The work you do is incredibly important. CursorToys wouldn't be nearly what it is today without your help filing bugs, updating documentation, guiding the design, or writing features. We want to say thank you and take time to recognize your work. Your contributions and feedback improve CursorToys month after month!

🤝 Contributing

This project welcomes contributions of all types. Besides coding features/bug fixes, other ways to assist include spec writing, design, documentation, and finding bugs. We are excited to work with the community to build a set of tools for helping you get the most out of Cursor AI.

We ask that before you start work on a feature that you would like to contribute, please read our Contributor's Guide. We would be happy to work with you to figure out the best approach, provide guidance and mentorship throughout feature development, and help avoid any wasted or duplicate effort.

For guidance on developing for CursorToys, please read the developer docs for a detailed breakdown. This includes how to setup your computer to compile.

📄 Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct.

🔒 Privacy

The extension does not collect personal or sensitive data. For more privacy information, see our Privacy Policy.

📝 License

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

Made with ❤️ for the Cursor community