Skip to main content
GitHub Repository: scoutqa-dot-ai/cursor-rulesAwesome Cursorrules: View on awesome-cursorrules
The Scout rules for Cursor bring vibe testing directly into your favorite AI code editor. Ask Cursor to test your web applications using natural language - no test scripts, no context switching.

​
What is Vibe Testing with Cursor?

Vibe testing is AI-powered exploratory testing designed for solo founders, vibe coders, and side project builders. With Scout rules installed in Cursor, you can:
  • Say “test my Lovable app” and get real bug reports
  • Run accessibility audits without leaving your editor
  • Validate user flows before shipping
This is QA that matches the speed of vibe coding - test as fast as you build.

​
Features

Natural Language Testing

Describe tests conversationally. “Test the checkout flow” or “Find bugs on the homepage.”

Platform Support

Works with Lovable, Replit, V0, Base44, Bolt.new, Vercel, Netlify, and any web app.

Accessibility Audits

Automatically identify WCAG compliance issues and accessibility barriers.

Zero Config

Drop the rules file in your project and start testing immediately.

​
Installation

​
Step 1: Install Scout CLI

First, install the Scout CLI globally: 
npm install -g @scoutqa/cli
scoutqa auth login

​
Step 2: Add Scout Rules to Cursor

​
Step 3: Restart Cursor

After adding the rules, restart Cursor to load them.

​
Usage

Once installed, simply ask Cursor to test your application: 
Test my app at https://myapp.lovable.app
Find any bugs or issues

​
Example Workflow

1

Build your feature

Write your code as usual in Cursor with AI assistance
2

Deploy to staging

Push to Lovable, Replit, Vercel, or your hosting platform
3

Ask Cursor to test

“Test the new checkout flow on https://myapp.lovable.app”
4

Review and fix

Cursor runs Scout and reports issues - fix them in the same session
You: I just deployed my Lovable app. Can you test the signup flow?
     https://myproject.lovable.app

Cursor: I'll run Scout to test the signup flow on your Lovable app.

[Running: scoutqa --url https://myproject.lovable.app --prompt "Test signup flow"]

Here's what Scout found:

Issues Detected:
1. Email validation accepts invalid formats (high severity)
2. Password field doesn't show requirements (medium)
3. Submit button missing aria-label (accessibility)

Passed:
✓ Form submits successfully with valid data
✓ Error messages display correctly
✓ Redirect to dashboard works

Recommendations:
- Add regex validation for email: /^[^\s@]+@[^\s@]+\.[^\s@]+$/
- Display password requirements above the field
- Add aria-label="Create account" to the submit button

Want me to help fix these issues?

​
Platform-Specific Examples

​
Testing Lovable Apps

Test my Lovable app for bugs
https://myproject.lovable.app

Focus on:
- User authentication
- Form submissions
- Mobile responsiveness

​
Testing Replit Deployments

Run a smoke test on my Replit project
https://myapp.replit.app

Make sure the main features work before I share it

​
Testing V0 Components

I built this UI with V0, can you test it?
https://myapp.vercel.app

Check if all the interactive elements work correctly

​
Troubleshooting

IssueSolution
Rules not loadingRestart Cursor after adding the .cursor/rules directory
Scout CLI not foundRun npm install -g @scoutqa/cli
Authentication errorsRun scoutqa auth login in your terminal
Tests failing to startEnsure your URL is publicly accessible
Check Scout CLI status: 
scoutqa auth status
scoutqa --version

​
Why Use Scout with Cursor?

Without ScoutWith Scout
Deploy and hope for the bestTest before every deploy
Find bugs from user complaintsCatch bugs before users do
Manual accessibility testingAutomated WCAG audits
Context switch to run testsTest without leaving Cursor

​
Frequently Asked Questions

Cursor rules are instructions that customize how Cursor’s AI behaves in your project. The Scout rules teach Cursor how to run vibe tests on your web applications using the Scout CLI.
Scout works with any publicly accessible URL. Deploy your Lovable or Replit app, then ask Cursor to test it. Scout will explore your app and report any issues it finds.
Scout requires publicly accessible URLs. For localhost testing, use a tunneling service like ngrok:
ngrok http 3000
# Then test the ngrok URL
The Cursor rules integrate Scout into Cursor IDE, while the Claude Code skill integrates Scout into Claude Code CLI. Choose based on your preferred editor.
Yes! Scout offers a free tier for solo founders and side projects. Install the CLI and start testing immediately.

​
Submit Your Own Rules

Using Scout with a specific framework or platform? Create custom rules and submit them to:
Scout requires a publicly accessible URL to run tests. Deployed environments like staging and production work immediately.For localhost testing, use a tunneling service like ngrok:
# Start your app, then create a tunnel
ngrok http 3000
Then ask Cursor to test the ngrok URL:
Test my app on https://abc123.ngrok.io
*Third-party tunneling services are not affiliated with Scout. Use at your own risk.