Cursor Rules - Vibe Testing in Cursor IDE - Scout - Find Bugs in Lovable, Replit, V0, Base44 Apps

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

Quick Setup (Recommended)
Manual Setup
Global Rules

Create the rules directory and download the Scout rules:

mkdir -p .cursor/rules
curl -o .cursor/rules/scout.mdc https://raw.githubusercontent.com/scoutqa-dot-ai/cursor-rules/main/scout.mdc

Create a .cursor/rules directory in your project root
Create a file called scout.mdc inside it
Copy the rules from our GitHub repository

To enable Scout across all your projects:

Open Cursor Settings (Cmd+, or Ctrl+,)
Search for “Rules”
Add the Scout rules to your User Rules

Step 3: Restart Cursor

After adding the rules, restart Cursor to load them.

Usage

Once installed, simply ask Cursor to test your application:

General Testing
Login Flow
Accessibility
Pre-Deploy

Test my app at https://myapp.lovable.app
Find any bugs or issues

Run an accessibility audit on my Replit app
https://myapp.replit.app

I'm about to deploy - can you run a quick smoke test?
https://staging.myapp.com

Example Workflow

Build your feature

Write your code as usual in Cursor with AI assistance

Deploy to staging

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

Ask Cursor to test

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

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

Issue	Solution
Rules not loading	Restart Cursor after adding the `.cursor/rules` directory
Scout CLI not found	Run `npm install -g @scoutqa/cli`
Authentication errors	Run `scoutqa auth login` in your terminal
Tests failing to start	Ensure your URL is publicly accessible

Check Scout CLI status:

scoutqa auth status
scoutqa --version

Why Use Scout with Cursor?

Without Scout	With Scout
Deploy and hope for the best	Test before every deploy
Find bugs from user complaints	Catch bugs before users do
Manual accessibility testing	Automated WCAG audits
Context switch to run tests	Test without leaving Cursor

Frequently Asked Questions

What are Cursor rules?

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.

How does this work with Lovable/Replit apps?

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.

Can I test localhost?

Scout requires publicly accessible URLs. For localhost testing, use a tunneling service like ngrok:

ngrok http 3000
# Then test the ngrok URL

What's the difference between this and the Claude Code skill?

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.

Is this free?

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:

awesome-cursorrules - Community collection of Cursor rules
cursor.directory - Cursor rules directory

Scout CLI - Run Scout from any terminal
Claude Code Skill - Use Scout in Claude Code
Kiro Power - Use Scout in Kiro IDE

Testing localhost applications

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.

Meet Scout

Scout in Action

Quick Run

Vibe Testing

Coming Soon

Cursor Rules - Vibe Testing in Cursor IDE

What is Vibe Testing with Cursor?

Features

Natural Language Testing

Platform Support

Accessibility Audits

Zero Config

Installation

Step 1: Install Scout CLI

Step 2: Add Scout Rules to Cursor

Step 3: Restart Cursor

Usage

Example Workflow

Platform-Specific Examples

Testing Lovable Apps

Testing Replit Deployments

Testing V0 Components

Troubleshooting

Why Use Scout with Cursor?

Frequently Asked Questions

Submit Your Own Rules

​What is Vibe Testing with Cursor?

​Features

Natural Language Testing

Platform Support

Accessibility Audits

Zero Config

​Installation

​Step 1: Install Scout CLI

​Step 2: Add Scout Rules to Cursor

​Step 3: Restart Cursor

​Usage

​Example Workflow

​Platform-Specific Examples

​Testing Lovable Apps

​Testing Replit Deployments

​Testing V0 Components

​Troubleshooting

​Why Use Scout with Cursor?

​Frequently Asked Questions

​Submit Your Own Rules

​Related

What is Vibe Testing with Cursor?

Features

Installation

Step 1: Install Scout CLI

Step 2: Add Scout Rules to Cursor

Step 3: Restart Cursor

Usage

Example Workflow

Platform-Specific Examples

Testing Lovable Apps

Testing Replit Deployments

Testing V0 Components

Troubleshooting

Why Use Scout with Cursor?

Frequently Asked Questions

Submit Your Own Rules

Related