Getting started with Cursor on the desktop
· Tutorial
This tutorial explains how to start Cursor using official pages retrieved on 16 November 2026: the documentation home, Quickstart, download page, Models & Pricing, and the help articles “Pricing and plans” and “Cancel your subscription.” Confirm current steps and prices on those pages before you install the app or subscribe. This guide does not assign a YearlyRank official score. See Cursor and methodology.
Purpose. Cursor’s documentation describes Cursor as a coding agent you can use to understand a codebase, plan and build features, fix bugs, review changes, and work with tools you already use. The official Quickstart is a desktop path: install the app, sign in, open a folder, ask Agent to explain the repo, make one small change, review the diff, and use Plan Mode when a larger change needs approval first. Terminal and Web products on the download page are not walked through here.
Steps
1. Install Cursor and sign in. Official Quickstart step 1 is: download Cursor, open the app, sign in, then pick a folder and start with a small task. The download page retrieved on 16 November 2026 listed the desktop app for macOS, Windows, and Linux, with 3.30 marked as Latest. Official system notes: macOS 12 (Monterey) and later, with a native .dmg and Apple Silicon and Intel support; Windows 10 and later, with a native .exe. For Linux, the Quickstart recommends Debian/Ubuntu packages, prefers apt and yum packages over AppImage, and documents the install commands, including a portable AppImage from cursor.com/downloads. If a sign-in method is not named on these pages, follow the live app.
2. Ask Agent to explain the folder you opened. After you pick a folder, official step 2 says to open Agent with Cmd I on macOS or Ctrl I on Windows and Linux, and to ask Cursor to explain the codebase and point out the main areas to read first. The documented example prompt is: “Explain this codebase. Point me to the main entry points, key modules, and anything I should read before making changes.” Official text says Cursor will search the repo, read relevant files, and summarize how the project fits together. For a longer orientation, the same page points to “Understand your codebase.”
3. Make one small change, then review the diff. Official step 3 says that once you understand the project, you can ask Cursor to suggest a few safe improvements, pick one, and ask it to make the change. The documented example prompt is: “Suggest three small, safe improvements in this codebase. Explain the tradeoffs and wait for me to choose one.” Official examples of low-risk first tasks include improving copy or fixing small UI issues. If you already know the change, ask for it directly. Official step 4 says the diff view shows the agent’s changes. When it finishes, review the diff and ask Cursor to run the checks your project already uses — tests, the type checker, linting, or a local build, as the Quickstart lists them. For a longer review workflow, it points to “Reviewing and testing code.”
4. Use Plan Mode when the work is larger. Official step 5 says Plan Mode is useful when a task spans multiple files, needs research, or needs approval before coding. Press Shift+Tab in the agent input to toggle it. Instead of writing code right away, official text says Cursor will research the codebase for relevant files, ask clarifying questions, create a detailed implementation plan, and wait for your approval before building. Official next-step pages include “Build new features,” Agent Overview, and Rules.
Plan and pricing notes
Official “Pricing and plans” and Models & Pricing, retrieved on 16 November 2026, say Cursor is sold as part of The X Subscription, one subscription for Grok, Cursor, and X. New customers choose a plan there. If you subscribed to Cursor before that launch, official help says you are on a legacy Cursor plan that keeps working as it is. Switching is optional; official help says a switch cancels the selected old plan with a prorated refund and is permanent.
Self-serve prices on those pages, excluding tax, were: Free at $0, with limited usage (official help lists Agent, Chat, and Tab completions with Cursor models, plus standard X; third-party models are not available); Plus at $8/month or $80/year; Premium at $30/month or $300/year (4× Plus usage); Super at $100/month or $1,000/year (15×); Ultra at $200/month or $2,000/year (50×); and Teams at $30, $100, or $200 per seat per month, matching the seat’s tier. Enterprise pricing is custom.
Official Models & Pricing says Plus runs Cursor’s own models (Grok 4.7, Grok 4.6, Grok 4.5, and Composer 2.5) at fixed settings: Fast off, medium effort, and Grok 4.7 with the 256k context window. Plus also includes Grok Chat, Voice, Imagine, Build, and Grok API access, and does not include Auto, Cloud Agents, Automations, Bugbot, Origin, third-party models, or your own API keys. Premium adds those agent and review features, Origin, third-party models at API list price from prepaid credit, and Grok Bot. Official docs say you can mix Premium, Super, and Ultra seats on a team; Plus is not available for teams. Third-party models on Teams and Enterprise are billed at API list price plus the Cursor Token Rate on eligible models.
Each paid plan includes one weekly pool of usage for Cursor models, shared across Grok and Cursor (official examples include Agent in the editor, CLI, Cloud Agents, Grok Bot, and the Grok apps). Remaining usage and the next reset are shown in editor settings and under Usage at grok.com/dashboard. Third-party models such as Claude, GPT, and Gemini are not in that pool; on Premium and above they are billed from prepaid credit at API list price from the first request. Official docs also describe top-ups, Auto Top-up, and a monthly additional-usage cap. Use the live Models & Pricing page for per-million-token rates.
To change or cancel a plan on The X Subscription, official help says: go to grok.com/dashboard/billing, open the options on the Current plan card, and follow the prompts. Upgrades apply immediately; downgrades apply at the end of the billing period. To cancel, choose cancel on that card and confirm. For a legacy Cursor plan, official help says to use cursor.com/dashboard/billing, then Manage in Stripe, then Cancel Subscription. After cancellation, official help says you keep paid features until the billing period ends, you are not charged again, and the account reverts to Free (or legacy Hobby), without deleting your account or local project files. Cancel iOS App Store purchases in Apple Settings and Grok Bot Android purchases in Google Play.
Who it fits
This start path fits someone who wants an official desktop coding agent for a local project folder and can install the macOS, Windows, or Linux app and sign in. It covers the documented Agent and Plan Mode workflow, not Terminal, Web, or API-only setup, and not the consumer Grok chat app.
Closing takeaway
Download Cursor from cursor.com/download, sign in, open a folder, and follow the official Quickstart: open Agent with Cmd I or Ctrl I, ask it to explain the repo, request one small change, review the diff, and use Shift+Tab for Plan Mode when the work is larger. New-customer plans listed on 16 November 2026 ran from Free at $0 to Ultra at $200/month, before tax, as part of The X Subscription. For current allowances and cancellation, use the live Models & Pricing page and Pricing and plans help.
Sources
Retrieved on 16 November 2026 (Asia/Shanghai):
- Cursor Docs, documentation home, https://cursor.com/docs
- Cursor Docs, “Quickstart,” https://cursor.com/docs/get-started/quickstart
- Cursor, download page, https://cursor.com/download
- Cursor Docs, “Models & Pricing,” https://cursor.com/docs/models-and-pricing
- Cursor Help, “Pricing and plans,” https://cursor.com/help/account-and-billing/pricing
- Cursor Help, “Cancel your subscription,” https://cursor.com/help/account-and-billing/cancel
- Cursor, pricing page, https://cursor.com/pricing