Girish KotteBook a call
AI kit · Cursor guide

Cursor IDE, the AI-first code editor.

Build software faster with an editor designed for AI pair programming. Get smart completions, built-in chat, and edits across your whole codebase.

VS CodeExtensions work
TabMulti-line autocomplete
Cmd+KInline edits
AgentMulti-file changes
Your first AI editmacOS · Windows · Linux
# select code, press Cmd+K
add input validation with zod
# open Agent with Cmd+I
@codebase where do we handle auth?
01Downloadcursor.com
02ImportVS Code settings
03Sign inGitHub or email
04StartPress Cmd+K
On Windows and Linux use Ctrl in place of Cmd.
01

What is Cursor IDE?

Cursor is an AI-first code editor. Built on VS Code, it adds AI features to tools you already know.

Three things to know
AI pair programmingCode with an AI that knows your codebase and writes alongside you
Natural language editingDescribe changes in plain English. Cursor updates your code.
Fast completionsMulti-line Tab suggestions as you type
Perfect forFull-stack developersMobile developersData scientistsStartup teams
Why choose Cursor over VS Code
Built-in AI from day oneAI is built into the core, not added as a plugin
Understands your entire codebaseThe project is indexed, so AI sees more than the current file
Privacy controlsSOC 2 Type II certified, with a Privacy Mode for your code
VS Code extension compatibleUse your favorite VS Code extensions without changes
02

Core features

Twelve capabilities in three groups. Pick a group to see what it covers.

Tab autocompleteMulti-line code suggestions that understand context and write full functions
Chat with codebaseAsk questions about your code and get answers with file links
Natural language editsDescribe changes in plain English. Cursor applies them for you.
Generate from commentsWrite a comment describing what you need. Cursor writes the code.
03

Shortcuts and context

The keys you will use every day, and the @ mentions that give AI the right context. Ctrl on Windows and Linux.

Keyboard shortcuts
Tab
Accept suggestionTake the autocomplete suggestion
CmdK
Inline editEdit the selection in plain language. In the terminal it writes the command.
CmdL
Open Agent with selectionSend the selected code to the side panel as context
CmdI
Toggle the side panelOpen Agent for bigger, multi-file changes
CmdShiftL
Add selection to chatAdd more code to the current chat
ShiftTab
Switch Agent modeRotate between the Agent modes
Cmd/
Switch modelLoop through your enabled AI models
Context with @
@file
Reference a file@src/app.ts
@folder
Reference a folder@components
@codebase
Search the whole project@codebase find auth logic
@docs
Attach documentation@docs nextjs app router
@web
Search the web@web latest react features
@symbol
Reference functions or classes@validateUser
04

Prompts and pro tips

Thirty-five tips and prompt templates. Search, filter, and copy the example.

Use @ symbols for precisionPoint Cursor at specific functions, classes, or variables
@validateEmail @UserSchema - refactor these to use Zod validation
Scope with @codebase wisely@codebase searches your whole project but can be slow. Use @folder for faster, targeted searches
@src/components - find all Button variants
Attach documentation with @docsAdd official docs so AI responses stay accurate and up to date
@docs next.js app router - implement parallel routes
Keep chat context focusedStart a new chat for each feature to keep context relevant. Archive old chats
One chat for auth, another for UI components
05

Project rules

Rules tell Cursor how your project works. Start from a template, then make it yours.

Next.js + TypeScript + Tailwind

Popular

Modern Next.js app with TypeScript and Tailwind CSS

# Project Context
You are working on a Next.js 15 application with TypeScript and Tailwind CSS.

## Tech Stack
- Next.js 15 with App Router
- TypeScript with strict mode
- Tailwind CSS for styling
- React 19
- ESLint + Prettier configured

## Code Style
- Use functional components with TypeScript interfaces
- Implement proper error boundaries
- Use server components by default, client components only when needed
- Follow REST API conventions for route handlers
- Implement proper loading and error states

## File Structure
- Components in /app/components
- API routes in /app/api
- Utilities in /lib
- Types in /types

## Best Practices
- Always use semantic HTML
- Implement proper SEO with metadata
- Ensure accessibility (ARIA labels, keyboard navigation)
- Optimize images with next/image
- Use dynamic imports for code splitting
- Implement proper error handling
- Write clean, self-documenting code

## Testing
- Write unit tests for utilities
- Integration tests for API routes
- Component tests with React Testing Library

## Do NOT
- Use 'any' type - always define proper types
- Ignore error handling
- Use inline styles when Tailwind classes exist
- Create unnecessary client components
- Forget to validate and sanitize user input
Save rules in .cursor/rules in your project (the older single .cursorrules file at the root still works).

Keep rules concise

Limit to 50-100 lines. Focus on your project's conventions, not general advice

Be specific

Include exact package versions, file paths, and naming conventions

Include examples

Show code snippets of preferred patterns

Define boundaries

Clearly state what not to do

Update regularly

Rules should evolve with your project

Scope appropriately

Use folder-specific rules for different parts of your app

06

Workflows and use cases

Step-by-step prompts for six real projects, and four everyday workflows.

Building a full-stack SaaS app

Advanced · 2-4 weeks

Build a full SaaS app from scratch with Cursor

  1. Setup
    Create a Next.js 14 app with TypeScript, Tailwind, Prisma, and NextAuth
    Use Agent for the initial scaffolding
  2. Schema
    @schema.prisma - Design a multi-tenant database schema for [your app]
    Let AI suggest relations and indexes
  3. Auth
    Implement NextAuth with Google and GitHub providers, add role-based access
    Reference NextAuth docs with @docs
  4. API
    Create CRUD API routes with proper validation using Zod
    Generate tests alongside APIs
  5. UI
    Build responsive dashboard with charts, tables, and forms
    Paste a screenshot into chat for UI inspiration
  6. Deploy
    Set up CI/CD with GitHub Actions and deploy to Vercel
    Let Cursor write the workflow files

Refactoring a legacy codebase

Intermediate · 1-2 weeks

Modernize an old JavaScript codebase to TypeScript

  1. Analysis
    @codebase - Analyze code quality and identify refactoring opportunities
    Start with a high-level assessment
  2. Types
    Convert this file to TypeScript with proper types and interfaces
    Do one module at a time
  3. Patterns
    Refactor class components to functional components with hooks
    Use Agent (Cmd+I) for multi-file changes
  4. Speed
    Find and fix performance bottlenecks, add memoization
    Ask for before/after metrics
  5. Tests
    Add full tests for refactored code
    Aim for 80% coverage

Building a Chrome extension

Intermediate · 3-5 days

Create a Chrome extension with AI-powered features

  1. Manifest
    Create Chrome extension manifest v3 with content scripts and popup
    Specify permissions needed
  2. Content
    Build content script to extract and analyze page content
    Handle different website structures
  3. Popup
    Create React popup with Tailwind styling
    Keep it lightweight
  4. Worker
    Set up service worker for API calls and storage
    Use Chrome storage API
  5. AI
    Add AI summarization and translation features
    Handle API keys securely

API to API migration

Advanced · 1-2 weeks

Move from REST to GraphQL or switch between API services

  1. Analysis
    Compare REST endpoints with GraphQL schema design
    Map all endpoints first
  2. Schema
    Design GraphQL schema with types, queries, and mutations
    Consider future needs
  3. Resolvers
    Create resolvers with data loaders for better performance
    Batch database queries
  4. Client
    Update frontend to use GraphQL with Apollo Client
    Add proper caching
  5. Rollout
    Create migration plan with feature flags and rollback
    Test thoroughly

Mobile app with React Native

Intermediate · 2-3 weeks

Build a cross-platform mobile app using React Native and Expo

  1. Setup
    Initialize Expo app with TypeScript, navigation, and common libraries
    Use Expo managed workflow
  2. UI
    Create reusable components with platform-specific styling
    Test on both iOS and Android
  3. State
    Implement Redux Toolkit with persist and async storage
    Keep state minimal
  4. API
    Connect to backend API with proper error handling
    Handle offline scenarios
  5. Native
    Add camera, location, and push notifications
    Request permissions properly

Data pipeline automation

Advanced · 1 week

Build an automated data processing pipeline with Python

  1. Ingest
    Create ETL pipeline to ingest data from multiple sources
    Handle different formats
  2. Process
    Build data cleaning and transformation logic with Pandas
    Optimize for large datasets
  3. Validate
    Add data quality checks and validation rules
    Log all issues
  4. Store
    Store processed data in PostgreSQL with proper indexing
    Consider partitioning
  5. Monitor
    Add monitoring, alerting, and retry logic
    Use Airflow or similar

Building a new feature

  1. Start with a comment describing the feature
  2. Let Cursor generate the initial structure
  3. Use chat to refine specific parts
  4. Ask Agent to generate the tests
  5. Review and polish with AI suggestions
Best for product development teams

Debugging complex issues

  1. Paste error message in chat
  2. Ask Cursor to explain the issue
  3. Get suggested fixes with explanations
  4. Apply fixes with one click
  5. Verify with AI-generated tests
Best for all developers

Code refactoring

  1. Select code to refactor
  2. Describe desired improvements
  3. Review AI suggestions
  4. Apply changes across files
  5. Ensure tests still pass
Best for maintaining legacy code

Learning new technologies

  1. Ask Cursor about the technology
  2. Get example implementations
  3. Understand best practices
  4. Generate boilerplate code
  5. Learn from AI explanations
Best for developers learning new stacks
07

Learning path

From first install to leading your team, in three stages. Tick tasks off as you go; progress saves in your browser.

1
Getting started with CursorBeginner · 1-2 weeks
  1. Day 1-2
    Installation and setupMilestone: complete your first AI-assisted edit
  2. Day 3-5
    Basic AI featuresMilestone: build a simple app with AI assistance
  3. Day 6-8
    Context and documentationMilestone: document an entire module
  4. Day 9-14
    First real projectMilestone: complete and deploy a project
2
Power user techniquesIntermediate · 2-3 weeks
  1. Week 1
    Advanced promptingMilestone: refactor a complex module
  2. Week 2
    Multi-file operationsMilestone: complete a codebase-wide refactor
  3. Week 3
    Rules and automationMilestone: a fully configured project with rules
3
Cursor masteryAdvanced · ongoing
  1. Month 1
    Architecture and designMilestone: design and build a production system
  2. Month 2
    Team workflowsMilestone: lead team adoption of Cursor
  3. Ongoing
    Cutting edgeMilestone: become the Cursor expert on your team
0 of 30Checklist items done
Daily practice
5 min
Start with Cmd+K for quick edits
10 min
Use chat for complex questions
10 min
Review AI-generated code carefully
5 min
Commit with AI-written messages
15 min
Refactor one function with AI
08

How Cursor compares

Cursor against the editors and assistants people usually weigh it against.

FeatureCursorVS Code
AI integrationBuilt inThrough extensions such as GitHub Copilot
Code completionMulti-line AI (Tab)IntelliSense, AI with an extension
Chat and agentBuilt inWith an extension
Codebase understandingIndexes the whole projectDepends on the extension
Extension supportVS Code compatibleFull support

Plans and features change often. Check each vendor's site before you buy.

09

Videos and podcasts

Tutorials worth your time, and the founders on how and why they built Cursor.

10

Troubleshooting

Common problems, the fixes to try in order, and how to avoid them next time.

Cursor is running slowly

  1. Clear chat history (archive old chats)
  2. Disable unused extensions
  3. Switch to a faster model
  4. Restart Cursor to clear memory
Prevent it: Keep chats focused on specific features

Autocomplete is laggy

  1. Check internet connection stability
  2. Disable autocomplete for very large files
  3. Close files you are not using
Prevent it: Use smaller, focused files when possible

High memory usage

  1. Close unused tabs and editors
  2. Limit number of open projects
  3. Clear Cursor cache
  4. Exclude build folders from indexing (.cursorignore)
Prevent it: Restart Cursor during long sessions
FAQ

Questions,
answered.

The six questions people ask most.

Ask on a call

Pro costs $20/month, and there is a free Hobby plan with limited agent requests and Tab completions. Try it on your own projects first and upgrade if the time saved is worth it to you.

Yes. Cursor is built on VS Code and supports nearly all VS Code extensions. You can import your full VS Code setup with one click.

Cursor is SOC 2 Type II certified and has a Privacy Mode in which your code is not stored or used for training. AI features still send code to Cursor and its model providers to work.

Models from Anthropic (Claude), OpenAI (GPT) and Google (Gemini), plus Cursor's own models. You can switch between them per chat based on your needs.

Basic editing works offline since it's built on VS Code. AI features need an internet connection, but you can code normally without it.

Cursor imports your VS Code settings, extensions, keybindings, and themes with one click during setup.

Next step

Ready to code with AI in your editor?

Download Cursor and work through the guide. If you want AI built into your product, book a call.