Skip to main content
Install the Sparkle Guardrails extension in Cursor to apply security guardrails on every AI prompt.

​
Prerequisites

  • Cursor installed on your machine
  • A Sparkle account (sign in after installation)

​
Install from the marketplace

Cursor uses the Open VSX Registry for extensions.
1

Open the Extensions panel

Press Cmd+Shift+X (Mac) or Ctrl+Shift+X (Windows/Linux), or click the Extensions icon in the activity bar.
2

Search for Sparkle Guardrails

Search for Sparkle Guardrails or thesparkle.sparkle-guardrails.
3

Install the extension

Select Sparkle Guardrails published by thesparkle, then click Install.
You can also open the extension page directly on Open VSX: Sparkle Guardrails.

​
Install from a VSIX file

If the extension does not appear in the marketplace or installation times out, install it manually from Open VSX.
1

Download the VSIX file

Open Sparkle Guardrails on Open VSX and download the .vsix file.
2

Install from VSIX

Open the Command Palette (Cmd+Shift+P or Ctrl+Shift+P), run Extensions: Install from VSIX…, and select the downloaded file.
3

Reload Cursor

Reload the window if prompted.
If a marketplace download saves without a .vsix extension, rename the file to end in .vsix before installing.
You can also drag the .vsix file into the Extensions panel, or install from the terminal: 
cursor --install-extension /path/to/thesparkle.sparkle-guardrails.vsix

​
Sign in

After installation, open Sparkle in Cursor and complete the sign-in flow with your Sparkle account.

​
Verify installation

1

Confirm the extension is enabled

In the Extensions panel, confirm Sparkle Guardrails appears under Installed.
2

Open a project

Open the repository you want to protect with Sparkle.
3

Run a prompt

Use Cursor’s AI features in that project. Sparkle applies guardrails on every prompt.

​
Next steps

Using the Extension

Learn the basic extension workflow.

Troubleshooting

Fix common installation issues.