Getting Started with Cursor | SheCodes

Getting Started with Cursor

Cursor is an AI-powered code editor built on top of VS Code. It looks and feels like VS Code, but with AI built in: an Agent panel that can read and edit your whole project, plus smart autocomplete as you type.

In this chapter

  • How to set up Cursor and start your first project
  • 3 starter prompts you can copy-paste right now
  • Tips and tricks specific to Cursor
  • Common first-time issues and how to avoid them

How to Get Started

  1. 1
    Download Cursor Go to cursor.com and download the app for your operating system. It installs just like any other app. If you use VS Code, Cursor can import all your settings and extensions automatically.
  2. 2
    Open a project Open an existing project folder or create a new one. Cursor works with any project in any language. If you don't have a project yet, create an empty folder and open it.
  3. 3
    Open the Agent panel Press Cmd+I (Mac) or Ctrl+I (Windows) to open Agent. Describe what you want and it reads your project, edits files, and runs commands. To work on specific code, select it and press Cmd+L (or Cmd+K) to send it to Agent.

Your First 3 Prompts

1. Understand a project (in the Agent panel)

“Explain what this project does and how it's structured. List the main files and what each one is for.”

2. Add a new feature (in the Agent panel)

“Add a contact form to this page with name, email, and message fields. Style it to match the existing design.”

3. Fix a bug (select the code, then Cmd+L)

“There's a bug where the mobile menu doesn't close after clicking a link. Find and fix it.”

Tips for Working with Cursor

Select code for small edits Select the code you want to change and press Cmd+L (Ctrl+L on Windows). Agent opens with those lines attached, so you can describe the change in one sentence.
Ask Agent big-picture questions Agent can search your whole project. Use it for questions like 'where does this data come from?' or 'how would I add authentication?'
Tag files with @ In the Agent panel, type @ to reference specific files. For example: '@src/app/page.tsx add a footer to this page'. This tells Cursor exactly which file to focus on.
Review changes carefully Cursor shows you a diff of every change Agent makes. Read the green (added) and red (removed) lines before you keep them.
Use Tab for autocomplete As you type code, Cursor suggests completions. Press Tab to accept. The suggestions are context-aware and get better the more code you have.

Common First Issues

You need a project folder first Unlike Bolt or Lovable, Cursor doesn't create projects from scratch. Create a folder, open it in Cursor, then ask Agent to scaffold the project.
Old tutorials mention Cmd+K edits Cursor replaced its Cmd+K edit bar with Agent. Cmd+K and Cmd+L now send your selected code to Agent, so select the code first, or name the file with @.
Check the terminal for build errors If your app isn't updating, check the terminal at the bottom of Cursor for error messages.