Quick start docs

Setup based on the official CursorToys extension docs. Follow these steps to install, configure essentials, and run your first practical workflow with sharing and HTTP validation.

1. Install

  • Install from Open VSX or a local VSIX package.
  • Open Command Palette and run `CursorToys: Show Menu`.
  • Confirm Explorer views appear: Notepads, Commands, Prompts, Plans, Skills, Hooks, and MCPB.

2. Configure base settings

  • Pick link behavior with `cursorToys.linkType` (deeplink, web, or custom).
  • Set folder strategy with `cursorToys.baseFolder` and `cursorToys.commandsFolder`.
  • Optionally adjust `cursorToys.allowedExtensions` and HTTP timeout defaults.

Install CursorToys

Use the deeplink button below to open Cursor and install using your package route.

3. First productive flow (recommended)

Share and import assets

  • Create a command or prompt file in your configured `.cursor`, `.claude`, `.vscode`, or `.ai` path.
  • Use share commands to generate deeplink, CursorToys bundle, or GitHub Gist.
  • Use `CursorToys: Import` (`Ctrl/Cmd+Shift+I`) to validate import on a clean location.

Run HTTP with assertions

  • Create `.req` or `.request` files under your HTTP folder.
  • Add `@assert()` annotations to validate response contracts and behavior.
  • Run request and review inline assertion results plus response output.

4. Optional modules to enable

MCPB and productivity tools

  • Install `.mcpb` packages from Command Palette and edit env vars in preview.
  • Enable AI text refinement with Gemini key configuration.
  • Use minify commands for files and clipboard when sharing payloads.

Remote and spending

  • Configure CursorToys Remote Chat for Telegram-driven workflows.
  • Use spending commands to track Auto/API usage from the status bar.
  • Tune refresh and token options in `cursorToys.spending.*` settings.

Troubleshooting

Import and sharing issues

  • Confirm link type matches your configured output (`deeplink`, `web`, or `custom`).
  • Verify destination folders are writable and extension type is allowed.
  • If URL payload is too large, share as CursorToys bundle or GitHub Gist.

HTTP and deeplink issues

  • Check selected environment and unresolved variables in request files.
  • Confirm `cursorToys.httpAssertionsEnabled` is active when tests do not run.
  • Allow browser custom-protocol prompts for Cursor deeplinks.

Launch test deeplink

Use the button below to verify your browser can hand `cursor:` protocol links to the editor.