Cursor at a Glance
Is Cursor Free?
Yes. The Free plan includes Agent, Chat, and Tab completions with limited use of Cursor’s own models (Grok and Composer), but not Claude, GPT, Gemini, or cloud agents. Cursor is sold as part of The X Subscription, one subscription for Cursor, Grok, and X. Each paid plan includes a weekly usage pool for Cursor’s own models, shared with the Grok apps.
Claude, GPT, and Gemini aren’t in any plan’s pool. On Premium and above you pay their API list price from prepaid credit that you top up. The pool resets weekly, and unused usage doesn’t roll over.
If you subscribed before The X Subscription, you may be on a legacy plan: Hobby (free), Pro ($20/month), Pro+ ($60/month), or Ultra ($200/month). Those plans keep working, but new customers can't buy them. That's why older articles list Cursor Pro at $20.
Prices are from cursor.com/pricing and Cursor’s Models & Pricing docs as of October 2026, and exclude tax. Cursor changes its plans from time to time, so check there before you buy.
How to Download and Install Cursor
- Go to cursor.com/download and pick your system: macOS 12 or later (Apple silicon or Intel), Windows 10 or later (x64 or ARM64), or Linux (
.deb, RPM, or AppImage, for x64 or ARM64) - Mac: open the
.dmgand drag Cursor into Applications. Windows: run the installer. Linux: install the package below, or run the AppImage. - Open Cursor and sign in, or create a free account
- Open your project with File > Open Folder
Import Your VS Code Settings
Cursor is built on VS Code. To bring over your extensions, themes, settings, and keybindings, open Cursor Settings (Cmd+Shift+J on Mac, Ctrl+Shift+J on Windows/Linux), go to General > Account, and click Import under VS Code Import. Cursor installs extensions from the Open VSX registry, not the VS Code Marketplace, so a few may be missing. The default shortcuts are the same as VS Code’s.
Install the Cursor CLI
Cursor’s agent also runs in a terminal. Install the CLI, then runagent in your project folder:
agent, add ~/.local/bin to your PATH.
How to Use Cursor
- Open Agent: press
Cmd+I(Mac) orCtrl+I(Windows/Linux) - Get oriented: ask “Explain this codebase. Point me to the main entry points and anything I should read before making changes.”
- Ask for a change: for example, “Add a dark mode toggle to the settings page.” Agent searches your code, edits files, and runs terminal commands.
- Review the diff: reject what you don’t want, then ask Agent to run your tests
- Undo a wrong turn: click a checkpoint in the chat to restore your files to that point
Shift+Tab in the chat input to switch modes:
Tab Completion
Tab is Cursor’s autocomplete. It suggests your next edit in gray text, sometimes several lines at once. PressTab to accept or Esc to reject, then Tab again to jump to the next spot Cursor expects you to edit.
Edit Selected Code
Select code and pressCmd+K or Cmd+L (Ctrl+K or Ctrl+L on Windows/Linux) to open a new Agent chat with the selection attached. Then say what to change, such as “Rename this to fetchOrders and update every caller.”
Rules
Rules are standing instructions Agent follows in every chat:- Project rules are
.mdcfiles in.cursor/rules/, checked into git. Create one with New Cursor Rule in the Command Palette, and choose whether it always applies, applies to matching files, or applies when relevant. - User rules apply to all your projects. Add them in Customize > Rules.
- AGENTS.md in your project root works too, and so does
CLAUDE.md.
.cursor/rules/style.mdc
Pick a Model
Choose a model in the picker in the chat panel, or pressCmd+/ (Ctrl+/ on Windows/Linux) to cycle through them. Auto picks one per request and bills it to your weekly pool (Plus doesn’t include Auto). Grok 4.7 is Cursor’s flagship model for the hardest tasks, and Composer is its fast, lower-cost model. Claude, GPT, and Gemini models, such as Claude Opus 5.5 and GPT-5.6 Sol, are available on Premium and above at API prices.
How to Add an MCP Server to Cursor
MCP (Model Context Protocol) lets Cursor’s agent use tools from other apps and services, such as GitHub, a database, or Vibecode. You can add a server in three ways:- From Cursor: open Customize > MCPs, find the server, click Add to Cursor, and follow its sign-in prompts.
- From an install link: some services publish a link that opens Cursor and asks Install MCP server? Vibecode’s link is below.
- By hand: edit
~/.cursor/mcp.jsonfor servers you want in every project, or.cursor/mcp.jsonin a project folder to share them through git. If a server name is in both, the project file wins.
command and args instead, as in the Xcode example below. Save the file and restart Cursor.
~/.cursor/mcp.json
Cmd+Shift+U or Ctrl+Shift+U) and choose MCP Logs.
How to Vibe Code an App with Cursor
“Vibe coding” means building by describing what you want and judging the result, instead of writing the code yourself (more in What is vibe coding? and Can I vibe code?). Cursor suits it if you’re comfortable with a project folder and a terminal:- Plan first: open an empty folder, switch to Plan mode, and describe the app, for example “Plan a web app for tracking my workouts, with a weekly summary. Ask me anything you need to know.”
- Build: fix anything wrong in the plan, then tell Agent to build it
- Check its work: ask Agent to start the dev server and test the app. It can control a browser to click through pages and take screenshots.
- Grow it one feature at a time, and add a rule when you correct the same mistake twice
How to Build an iPhone App with Cursor
On your own, you need a Mac with Xcode. With Vibecode connected, you don’t.On Your Own: Cursor and Xcode on a Mac
Cursor can write Swift and SwiftUI, but an iPhone app is built and run with Xcode, which needs a Mac. Cursor’s Swift guide suggests editing in Cursor and switching to Xcode to build and run. With Xcode 26.3 or later and a paid Cursor plan, Cursor’s agent can drive Xcode through its built-in MCP server to build, run tests, and capture SwiftUI previews while Xcode is open. Turn on Xcode Tools in Xcode > Settings > Intelligence > Model Context Protocol, then add the server:~/.cursor/mcp.json
With Vibecode: No Mac Needed
Connect Vibecode’s MCP server, and Cursor’s agent directs Vibecode’s agent, which writes the app, builds it on cloud Macs, tests it, and saves it to your Vibecode account. Cursor runs on Mac, Windows, and Linux, so you can build a native iPhone app from any of them.1
Add Vibecode to Cursor
Open Add Vibecode to Cursor. Cursor opens and asks Install MCP server? Leave the client ID and secret empty, and select Install. (Or add the
mcp.json entry from the MCP section above.)2
Sign in to Vibecode
Vibecode shows Needs authentication. Select Authenticate, sign in to Vibecode (or create an account), and select Allow. Vibecode then shows its tools as enabled.
3
Ask for an app
Open Agent and describe the app you want.
- “Using Vibecode, build me an iPhone app to track my workouts, with a weekly summary.”
- “Build me a web app to plan my meals for the week.”
- “Show me my Vibecode apps.”
- “Make the buttons in my workout app blue and add a rest timer.”
- “Why did the last build of my habit tracker fail?”
run_command it runs a shell command in the app’s cloud workspace, for example to run tests or check a package version. A command stops after 45 seconds.
Connecting is free, and builds and changes use your Vibecode credits. New accounts that sign up with Google or Apple get their first app build free. After that, plans start at $20/month with $20 in credits, and credits roll over (Vibecode pricing, as of October 2026).
Either way, publishing to the App Store needs an Apple Developer Program membership.
Open a Vibecode Project in Cursor over SSH
On Vibecode’s Pro and Max plans you can open a Vibecode project in Cursor over SSH and edit its code with Cursor’s own agent (Export and SSH). With the Vibecode CLI, Cursor’s agent writes the code and uses Vibecode’s sandboxes, databases, sign-in, and hosting to run and publish it. Vibecode builds iPhone, Android, and web apps. For a backend service, a library, a desktop app, or an existing codebase, use Cursor on its own. For a full side-by-side, see Vibecode vs Cursor.Frequently Asked Questions
Is Cursor free?
Is Cursor free?
Yes. The Free plan includes Agent, Chat, and Tab with limited use of Cursor’s own models (Grok and Composer), but not Claude, GPT, or Gemini. Paid plans start at $8/month as of October 2026.
How much does Cursor cost?
How much does Cursor cost?
As of October 2026, Plus is $8/month, Premium $30/month, Super $100/month, and Ultra $200/month. Claude, GPT, and Gemini cost extra, at API list price. The older Pro plan ($20/month) still works for existing subscribers but isn’t sold to new customers.
Is Cursor based on VS Code?
Is Cursor based on VS Code?
Yes. Cursor is built on VS Code and uses the same default shortcuts. Import your extensions, themes, settings, and keybindings from Cursor Settings > General > Account > VS Code Import.
How do I add an MCP server to Cursor?
How do I add an MCP server to Cursor?
Click Add to Cursor on a server in Customize > MCPs, open the server’s install link, or add it to
~/.cursor/mcp.json. For Vibecode, open Add Vibecode to Cursor, select Install, then Authenticate.Can Cursor build iPhone apps?
Can Cursor build iPhone apps?
On your own, Cursor writes the Swift code and Xcode on a Mac builds and runs it. With Xcode 26.3 or later and a paid plan, Cursor’s agent can run Xcode’s builds, tests, and previews. With Vibecode connected, Vibecode builds the app on cloud Macs, so you don’t need a Mac. See Native iOS Apps.
Cursor vs Claude Code: which should I use?
Cursor vs Claude Code: which should I use?
Cursor is a code editor with its own agent and a choice of models: its plans cover Cursor’s own models, and Claude, GPT, and Gemini cost extra. Claude Code is Anthropic’s coding agent, built on Claude. It runs in your terminal and in editors such as VS Code and Cursor, and needs a paid Claude plan (Pro is $20/month). You can use both, since the Claude Code extension installs in Cursor. See How to Use Claude Code.
Can I use Claude or GPT in Cursor?
Can I use Claude or GPT in Cursor?
Yes, on Premium ($30/month) and above. You pay each model’s API list price from prepaid credit. Free and Plus include only Cursor’s own models.
Do I need to know how to code to use Cursor?
Do I need to know how to code to use Cursor?
Not to start, but Cursor expects you to read its changes, run your project, and set up hosting yourself. For a finished iPhone app without that work, connect Vibecode, or build your first app in Vibecode.
Next Steps
Connect Vibecode to Your AI Tool
Set up Vibecode in Cursor, Claude Code, Codex, and more
How to Use Claude Code
Install, cost, and building apps with Anthropic’s agent
How to Use Codex
OpenAI’s coding agent, and building apps with it
How to Use Gemini CLI
Google’s coding agent in your terminal
Vibecode vs Cursor
An app builder and an AI code editor, side by side
Native iOS Apps
Swift apps for iPhone, built on cloud Macs
