Skip to content

Quick Start Guide

Get up and running with Cursor's core AI features in 5 minutes.

Prerequisites

The Three Core Features

FeatureShortcutUse For
Tab AutocompleteTabSingle/multi-line completions
Inline EditCmd+KEdit selected code inline
Agent ChatCmd+IComplex tasks autonomously

Step 1: Tab Autocomplete

Tab provides intelligent code completions as you type.

Try It Now

  1. Open any code file
  2. Start typing: function calculate
  3. See ghost text appear with suggestions
  4. Press Tab to accept, Escape to reject

Key Commands

ActionShortcut
Accept suggestionTab
Reject suggestionEscape
Accept word-by-wordCmd+→ / Ctrl+→

Jump Feature

After accepting a Tab suggestion, press Tab again to jump to the next logical edit location in your file.

Step 2: Inline Edit (Cmd+K)

Edit code directly using natural language.

Try It Now

  1. Select a function in your code
  2. Press Cmd+K (Mac) or Ctrl+K (Windows/Linux)
  3. Type: "add error handling for null inputs"
  4. Press Enter to apply

Modes

ModeHow to TriggerUse Case
Edit SelectionSelect code + Cmd+KModify specific code
GenerateNo selection + Cmd+KCreate new code at cursor
Quick QuestionAlt+Enter in promptAsk about code without changing it
Full FileCmd+Shift+EnterComprehensive file changes

Quick Question

Press Alt+Enter instead of Enter to ask a question about the code. Then type "do it" to apply the suggestion.

Step 3: Agent Chat (Cmd+I)

Let AI handle complex, multi-step coding tasks.

Try It Now

  1. Press Cmd+I (Mac) or Ctrl+I (Windows/Linux)
  2. Type: "Create a React component for a todo list with add and delete functionality"
  3. Watch Agent create files, write code, and run commands

Agent Modes

Switch modes with Cmd+. or Ctrl+.:

ModeBest For
AgentComplex features, refactoring, multi-file changes
AskQuestions, learning, code exploration (read-only)
PlanComplex tasks requiring upfront planning
DebugTricky bugs, hypothesis-driven debugging

Step 4: Add Context with @ Mentions

Give AI better context for more accurate responses.

Try It Now

In any chat or inline edit prompt, type @ to see options:

MentionWhat It Does
@FilesReference specific files
@FoldersReference entire folders
@CodeReference specific code sections
@DocsUse external documentation

Example: "@package.json add a new script called 'test:coverage' that runs jest with coverage"

Step 5: Review Changes

Cursor shows diffs before applying changes.

Review Workflow:

  1. AI proposes changes
  2. You see: -old code (red) / +new code (green)
  3. Accept (Cmd+Enter) or Reject (Cmd+Backspace)
ActionShortcut
Accept all changesCmd+Enter / Ctrl+Enter
Reject all changesCmd+Backspace / Ctrl+Backspace
Accept individualClick checkmark on change

Next Steps

Now that you know the basics:

  1. Configure Rules - Set up persistent AI instructions for your project
  2. Set Up MCP Servers - Connect to external tools like databases
  3. Learn Agent Modes - Master all four Agent modes
  4. Review Keyboard Shortcuts - Memorize key shortcuts for speed

Pro Tip

Create a .cursor/rules directory with project-specific rules. This gives AI consistent guidance across all your coding sessions.

Troubleshooting

Having issues? Check these first:

ProblemSolution
AI not respondingCheck network: Cursor Settings > Network > Run Diagnostics
Slow completionsDisable heavy extensions, check Process Explorer
Wrong suggestionsAdd more context with @ mentions

See the full Troubleshooting Guide for more solutions.

Built with VitePress | Powered by Claude AI