Cursor: installing and setting up
Cursor: ReviewInstall & set upNewsTechnical tutorial
As of September 2026, compiled from our own notes and news archive; text machine-generated and editorially checked. Check versions and commands in the official documentation.
In this guide you install Cursor, the AI code editor with a built-in agent, on macOS, Windows or Linux. You log in, configure privacy properly, give your project rules and, if desired, also install the command-line agent. Everything is based on the official documentation (as of September 2026).
What you need
- Operating system: macOS 12 (Monterey) or newer, Windows 10 or newer, or Linux (Debian/Ubuntu, RHEL/Fedora or AppImage).
- Account: a Cursor account. The free Hobby plan works without a credit card, but with a limited number of agent requests. For daily work you need a paid plan (see the review).
Installing the editor
Download Cursor from cursor.com/downloads and install it like any other program.
- macOS: open the
.dmgfile and drag Cursor to Applications. - Windows: run the installer.
- Linux: preferably choose the
.debor.rpmpackage. These give you a menu shortcut, automatic updates and the command-line tools; the AppImage does not have that.
Cursor is based on VS Code. On first launch you can import your VS Code extensions, themes and keyboard shortcuts, so your familiar environment is ready straight away.
Logging in and opening a project
- Start Cursor and log in (or create an account).
- Choose Open Folder and open your project folder.
- Open the agent with Cmd+I (Mac) or Ctrl+I (Windows/Linux).
Setting privacy correctly straight away
Are you working on code that must not go outside? Then turn on Privacy Mode immediately: your code will then not be used by Cursor or the model providers for training.
- Open the settings with Cmd+Shift+J (Mac) or Ctrl+Shift+J (Windows/Linux).
- Go to General.
- Turn on Privacy Mode.
On Teams and Enterprise accounts, Privacy Mode is on by default; with an individual account you have to turn it on yourself.
Rules for your project
Cursor follows instructions you put in your project. There are two simple ways.
AGENTS.md: a normal markdown file in the root of your project.
# AGENTS.md
- Dit is een Next.js-project met TypeScript.
- Tests draaien met `npm test`; draai ze na elke wijziging.
- Gebruik geen nieuwe dependencies zonder te vragen.
Project rules: .mdc files in .cursor/rules/. These offer more control, for example a rule that applies only to certain files. Note: ordinary .md files in that folder are ignored. An example, .cursor/rules/componenten.mdc:
---
description: "Standaarden voor frontend-componenten"
globs: src/components/**/*.tsx
alwaysApply: false
---
- Gebruik functionele componenten met TypeScript-props.
- Styling via Tailwind-klassen, geen losse CSS-bestanden.
The first task
Start small. First ask the agent to explain your codebase, for example: "Explain how authentication works in this project." Then let it make a small change and review the difference before you accept it.
For larger tasks, turn on Plan Mode with Shift+Tab. The agent then first examines the relevant files, asks questions, makes a plan and waits for your approval before writing code.
Optional: the command-line agent
Cursor also has an agent for the terminal, useful for scripts and CI.
macOS, Linux and WSL:
curl https://cursor.com/install -fsS | bash
Windows (PowerShell):
irm 'https://cursor.com/install?win32=true' | iex
The program is called agent. Try it in your project folder:
agent "Leg in drie zinnen uit wat dit project doet."
Checking and updating
- If the agent works in the editor and sees your rules (ask: "which project rules are you following?"), the installation is fine.
- The editor updates itself on macOS, Windows and via the Linux packages. With the AppImage you download a new version yourself.