Last updated: April 14, 2026 — Covers Cursor 3.1 (released 2026-04-13)

📑Table of Contents
  1. Before you install — account and system check
  2. Step 1 — Open the official site
  3. Step 2 — Download the installer
  4. Step 3 — Install Cursor
  5. Step 4 — First launch and setup
  6. After install — pricing and what the free plan covers
  7. How to uninstall Cursor
  8. FAQ
  9. Related articles
  10. Wrap-up
Install Cursor — official homepage of the AI code editor at cursor.com
The official Cursor homepage at cursor.com

Cursor is an AI-powered code editor built on top of VS Code. On my Apple Silicon M4 Max running macOS Tahoe, a full reinstall — from clicking Download to a signed-in editor with the workspace indexed — took about 5 minutes. If you already use VS Code, the import wizard carries over your extensions, keybindings, and themes. In this guide I walk through macOS and Windows step by step with screenshots, then cover what the official docs leave out: real-world timings, the gotchas I’ve seen, and the files you need to delete for a clean uninstall.

⏱ TL;DR — What you’ll learn

  • How long it takes: a few seconds to download on 1 Gbps, ~10 seconds to copy into Applications, and about 5 minutes total including first-launch setup
  • Supported platforms: macOS (ARM64 / x64 / Universal), Windows (x64 and ARM64, each in System and User installers), Linux (.deb / .rpm / AppImage)
  • Before you start: create a Cursor account first so sign-in is instant (the free Hobby plan still unlocks AI completions)
  • VS Code users: the first-launch wizard imports extensions, keybindings, and themes in one click

For a deeper look at what the editor can do, see 👉 What is Cursor? A complete feature overview.


Before you install — account and system check

Two things to get out of the way before you download. First, create a Cursor account — you’ll need it at first launch. Second, confirm your machine meets the requirements.


System requirements (April 2026, based on my measurements)

Component Minimum Recommended (my experience)
OSmacOS 12+ / Windows 10 / Ubuntu 20.04macOS 14+ / Windows 11 / Ubuntu 22.04 LTS
CPUx64 / ARM64Apple Silicon / Ryzen 7 or better
Memory8 GB16 GB+ (32 GB for very large monorepos)
Disk2 GB free~800 MB install + cache headroom
NetworkAlways-on (required for AI features)Wired / fiber preferred

📏 Memory footprint I’ve measured: on macOS Tahoe / M4 Max, a small project sits at 400–800 MB. Opening several large codebases at once — a WordPress theme with ~10,000 files, for example — pushes memory past 1 GB and occasionally close to 5 GB, especially during the first index. On an 8 GB machine I’d close unrelated apps before the first launch.


Supported platforms and build matrix

OS Package Notes
macOS.dmg (ARM64 / x64 / Universal)Pick ARM64 on Apple Silicon. CLI users can also run brew install --cask cursor
Windows.exe (x64 / ARM64 × User / System)Choose User Installer on locked-down corporate machines
Linux.deb / .rpm / AppImage (ARM64 / x64).deb for Ubuntu/Debian, .rpm for Fedora/RHEL, AppImage for portable use

Step 1 — Open the official site

Start by heading to the Cursor website.

Official site: https://cursor.com/

Install Cursor download page listing every platform build
The download page at cursor.com/download — the current release is Cursor 3.1 (2026-04-13)

Use the Download for macOS button on the homepage, or jump straight to cursor.com/download for every platform build. The page also lists previous versions (3.0 / 2.6 / 2.5 / 2.4) — handy when you need to roll back for compatibility.


Step 2 — Download the installer


macOS

📝 Steps

  1. Click Download for macOS
  2. A .dmg (roughly 210–250 MB) starts downloading
  3. On a 1 Gbps connection, this takes a few seconds in my experience

💡 Apple Silicon vs. Intel

The Download button auto-detects your OS and CPU, so Apple Silicon (M1/M2/M3/M4) and Intel each get the right build. To pick manually, open the download page and choose ARM64, x64, or Universal explicitly.

For CLI users: brew install --cask cursor works just as well. You can also keep updates in sync with brew upgrade --cask cursor — convenient if you already manage other apps with Homebrew.


Windows

📝 Steps

  1. Click Download for Windows
  2. An .exe file starts downloading

💡 User Installer vs. System Installer

For personal use, the User Installer (default) is fine — it installs under your user profile and needs no admin rights. Pick the System Installer only when you need a machine-wide install, for example on shared corporate hardware. On ARM64 Windows devices (Snapdragon X Elite and similar), the ARM64 build is noticeably faster than running x64 under emulation.


Step 3 — Install Cursor


macOS

📝 Steps

  1. Double-click the downloaded .dmg
  2. Drag the Cursor icon into the Applications folder (the copy takes about 10 seconds)
  3. Eject the .dmg from Finder
  4. Launch Cursor from Applications

⚠️ If Gatekeeper says “cannot verify the developer”

The easiest fix is to right-click Cursor in Applications and choose “Open”, then click Open in the dialog. If it still refuses, open System Settings → Privacy & Security and click Open Anyway. You only have to do this once — subsequent launches skip the warning.


Windows

📝 Steps

  1. Double-click the downloaded .exe
  2. Accept the license agreement
  3. When the installer finishes, Cursor launches automatically

⚠️ If SmartScreen blocks the installer

When “Windows protected your PC” appears, click More info and then Run anyway. On a corporate device where you don’t have admin rights, re-download the User Installer — it doesn’t need elevated permissions and sidesteps the prompt.

🧰 If the download stalls: (1) try a different browser (Chrome → Safari / Edge), (2) toggle your VPN off, (3) clear the browser cache and re-download, (4) ask IT to add cursor.com and downloads.cursor.com to the proxy allow-list. I haven’t hit any of these myself, but readers on locked-down corporate networks have asked about each of them.


Step 4 — First launch and setup

Cursor first launch after install — welcome state of the AI code editor
Cursor on first launch — a few clicks from here and your VS Code setup is migrated

On first launch, Cursor shows a welcome screen that walks you through the initial setup. On my macOS Tahoe / M4 Max machine, this step — including the first workspace index — took about 5 minutes.

🎨 Theme

Choose Dark or Light. You can change it later from Settings.

📦 Import from VS Code

One click brings over your extensions, keybindings, and settings.


Migrating from VS Code — what actually carries over

The official docs just say “your extensions work.” I wanted more detail, so here’s what actually transferred on my setup (a Japanese-localized VS Code, migrated through the import wizard).

✅ Imported cleanly on my machine

  • Extensions: ESLint, Prettier, GitLens, Japanese Language Pack, Markdown All in One and the other common tools worked without changes
  • Keybindings: VS Code shortcuts came through intact. Cursor’s AI-chat shortcuts take priority in a few places, so it’s worth glancing at the bindings once
  • Themes and fonts: Dark+ and my custom editor font carried over with no adjustment
  • settings.json: every key that exists in VS Code kept working. Cursor simply appends its own AI-related keys alongside them

💡 Tweaks I made after the import:

  • Reviewed Cursor’s AI settings (context scope, default model) to match how I actually work
  • Added a .cursorrules file at the project root so Cursor picks up our code style and naming conventions
  • Left Settings Sync on in VS Code only and kept Cursor’s settings local, so the two editors don’t fight over the same account

🔑 Sign in to your Cursor account

AI features (completions, chat, agents) require a Cursor account. You can sign up with email or GitHub. Creating the account before you install avoids a detour on the sign-in screen. The free Hobby plan already unlocks the core AI features.


After install — pricing and what the free plan covers

“How to install Cursor free?” is one of the top People-Also-Ask queries, so here’s the pricing picture along with my own usage.

Plan Monthly Who it fits
Hobby (free)$0Trying it out, Tab-completion-heavy light use
Pro$20Individual developers using Composer and switching models often
Ultra$200Heavy users who rely on parallel agent runs

💰 My own budget (Pro at $20/month):

  • On the free Hobby plan, a Tab-completion-focused workflow lasted me about 1–2 weeks before I hit limits — quotas shift with your account and the time of year, so treat that as a rough guide
  • I upgraded the moment I started leaning on long Composer sessions and switching models frequently for cost/quality trade-offs
  • To stretch the free plan: (1) keep the model on Auto, (2) keep chats short so you aren’t shipping unnecessary context, (3) reach for Composer only when you really need it

For a breakdown of each plan and the usage-based billing, see The complete Cursor pricing guide.


How to uninstall Cursor

Removing the app alone leaves configuration and cache behind. For a clean uninstall, delete the directories below as well.

🍎 macOS

  1. Drag Cursor from Applications to the Trash
  2. For a full wipe, also remove:
    • ~/.cursor (user settings, .cursorrules, etc.)
    • ~/Library/Application Support/Cursor
    • ~/Library/Caches/Cursor
    • ~/Library/Logs/Cursor

🪟 Windows

  1. Uninstall Cursor from Settings → Apps
  2. For a full wipe, also delete:
    • %APPDATA%\Cursor
    • %LOCALAPPDATA%\Programs\Cursor
    • %USERPROFILE%\.cursor

FAQ

How do I properly install Cursor?

Download the installer for your OS from cursor.com/download (.dmg for macOS, .exe for Windows, .deb/.rpm/AppImage for Linux), drag the app into Applications on macOS, run the .exe on Windows, or install through your package manager on Linux. Launch the app and sign in, and you’re done.

Can I install Cursor on Windows?

Yes — Windows 10 and 11 are both supported, with separate x64 and ARM64 builds in User and System Installer variants. Use the User Installer for personal machines and the System Installer for machine-wide deployments. On Snapdragon X Elite and similar ARM devices, the ARM64 build runs noticeably faster than x64 under emulation.

How do I install Cursor for free?

The installer itself is free. The Hobby plan includes AI completions and chat but caps usage — in my case that lasted about 1–2 weeks of light, Tab-focused coding before I hit limits. Serious daily use fits the Pro plan ($20/month); if you run agents in parallel, consider Ultra ($200/month).

Do VS Code extensions work in Cursor?

Nearly all of them. On my setup, ESLint, Prettier, GitLens, Japanese Language Pack, and Markdown All in One all worked right after the first-launch import wizard. Keybindings, themes, and settings.json transfer in the same step.

Can I install Cursor and VS Code side by side?

Yes. They install as separate apps and don’t interfere, so you can pick whichever editor fits each project. If you use Settings Sync, keep it enabled in only one of the two to avoid fighting over the same cloud profile.

macOS says “cannot verify the developer” at install — what now?

That’s Gatekeeper. The simplest fix is to right-click Cursor in Applications and choose “Open”, then click Open in the dialog. If that fails, open System Settings → Privacy & Security and click Open Anyway. You only need to do this once.

How do I uninstall Cursor?

On macOS, drag Cursor from Applications to the Trash; on Windows, uninstall from Settings → Apps. For a clean removal also delete ~/.cursor, ~/Library/Application Support/Cursor, and ~/Library/Caches/Cursor on macOS, or %APPDATA%\Cursor, %LOCALAPPDATA%\Programs\Cursor, and %USERPROFILE%\.cursor on Windows.

krona23

Author

krona23

Over 20 years in the IT industry, serving as Division Head and CTO at multiple companies running large-scale web services in Japan. Experienced across Windows, iOS, Android, and web development. Currently focused on AI-native transformation. At DevGENT, sharing practical guides on AI code editors, automation tools, and LLMs in three languages.

DevGENT about →



Wrap-up

My takeaway — Cursor installs in five minutes, and the VS Code switch is practically a single click

  1. Grab the installer from the official site
  2. Drag into Applications (10 seconds) on macOS, or run .exe on Windows
  3. First-launch wizard → theme, VS Code import, and sign-in → you’re coding with AI in ~5 minutes

If you already use VS Code, the workhorse extensions (ESLint, GitLens, and the rest) keep working without changes. The free Hobby plan is enough for 1–2 weeks of light exploration; for daily use, Pro at $20/month is the sweet spot. Install it, try it on a real project, and only then compare it to other editors.
👉 What is Cursor? A complete feature overview
👉 AI editor comparison

Leave a Reply

Trending

Discover more from DevGENT

Subscribe now to keep reading and get access to the full archive.

Continue reading