Dylan AndersenDylan Andersen's Docs
Cursor + SalesforceExpert Cursor

Keeping Cursor Current

Update Cursor, read the release notes, opt into the beta channel, and roll back when something breaks

Cursor ships fast. New features every few weeks, occasional rewrites of the UX, and the very rare regression. A page of habits keeps you on the good parts of that pace without being the SE who can't find Tab Mode five minutes before a demo.

Keeping Cursor Current hero

The update loop

Cursor auto-updates by default. The flow:

  1. A new version is published.
  2. Your Cursor notices within a few hours and downloads the update.
  3. Next time you quit and reopen, you're on the new version.

That's fine 95% of the time. For the other 5%, you want to know:

  • How to check your current version.
  • How to update manually.
  • How to read the release notes before the update.
  • How to roll back if something breaks.

Check your version

Cursor menu > About Cursor

Or from the command palette (Cmd+Shift+P):

> About Cursor

Note both the Cursor version and the underlying VS Code version. Extension issues often track VS Code compatibility.

Force an update

Cursor menu > Check for Updates

If an update is downloaded but not yet applied, quit and relaunch. On macOS, Cmd+Q and reopen. On WSL + Windows, quit the Windows-side Cursor process, not the Ubuntu one.

Opt into the beta channel

Settings > Beta Program > Turn on.

You get features a week or two early. You also get the occasional bug. Two rules of thumb:

  1. Don't run beta during customer work you can't back out. Use a stable channel install for customer demos.
  2. If a beta breaks something critical, switch back to stable immediately. The setting toggles channel; quit and reopen and you get the latest stable build.

Release notes

Cursor posts release notes to cursor.com/changelog. Read them. They're short, opinionated, and often mention a shortcut or model change that saves you time.

The highest-signal things to watch for:

  • New context primitives. New @ mentions or similar. These quietly upgrade your day.
  • Model menu changes. New model added, old one deprecated. If your default model disappears, the picker silently defaults you to something else.
  • Agent mode behaviour changes. Auto-run defaults, context inclusion, subagent capabilities. These shape what you can trust the agent to do unattended.
  • Hook / rule / skill schema changes. Rare but impactful. If a hook stops firing after an update, check for schema notes.

Pro pattern: subscribe to the changelog RSS feed (most feed readers can handle it) so you don't have to remember to check.

Rolling back

When an update breaks something you care about and a fix isn't out yet.

Cursor keeps older versions on disk under ~/Library/Application Support/Cursor/backups/ on some versions, but the reliable path is to download the specific older build from Cursor's release archive (reach out to support or the community for the direct link). Replace the app bundle in /Applications/, reopen, and disable auto-update until the regression is fixed.

Disable auto-update in: Settings > Update > Update Mode > Manual.

Uninstall the current Cursor from Add/Remove Programs. Download the previous build from Cursor's release archive. Install. Disable auto-update in Settings > Update > Update Mode.

Cursor runs as a Windows app connecting into WSL. The rollback is a Windows-side operation. Follow the Windows path above. Your WSL projects and .vscode-server cache are unaffected by the Cursor version swap.

Don't stay rolled back forever. New versions often fix the thing that made you roll back. Set a calendar reminder to re-test the next stable release.

Syncing your config across machines

SEs often work across laptops: personal, loaner, demo desk. Cursor's Settings Sync keeps user rules, model preferences, and keybindings consistent across installs.

Settings > Account > Settings Sync > Enable.

Sign in with the same identity (SSO, usually) on each machine. Things that sync:

  • User rules (global).
  • Model preferences and the model picker order.
  • Keybindings.
  • Installed skills that live in your user directory.
  • Settings JSON.

Things that don't sync:

  • Project rules (.cursor/rules/*.mdc). These live in the project repo. That's correct; you want them checked into git.
  • MCP server configurations. Those live in the project's .mcp.json. Also correct.
  • Hooks (.cursor/hooks.json). Same.

The boundary: user-scoped stays with your account, project-scoped stays with the project. Treat them that way and switching laptops stops being painful.

Reading the agent's version

Sometimes "this broke after an update" isn't Cursor. It's the model shifting. Cursor exposes which model served a given response in the agent chat sidebar. If a prompt that used to work returns nonsense:

  1. Check which model answered.
  2. Switch to the previous model in the picker.
  3. If the old model fixes it, you've isolated a model regression, not a Cursor regression.

Report the model regression via the feedback option inside Cursor. The team reads these.

Common traps

"I can't find X anymore"

Cursor reorganises the UI periodically. Command palette is the answer: Cmd+Shift+P and start typing what you want. Almost everything has a command.

A skill stopped working after an update

Skill schemas evolve. Usually an update adds a new field the skill doesn't define; sometimes it deprecates one. Pull the latest version of the skill from its source (GitHub, internal registry) and reinstall.

MCP server won't connect after an update

The MCP transport spec has changed a couple of times. If a stdio server stops working, run the command manually first to see if it still launches. If it launches manually but not through Cursor, check the MCP config schema against the current release.

Auto-run toggle behaviour changed

Auto-run defaults have tightened as Cursor's matured. If the agent is now prompting for confirmation on commands that used to run silently, that's working as intended. Read the current auto-run docs and decide which commands you genuinely want to skip confirmation for.

Verification

After an update, run this 30-second smoke check:

  1. Open a project you know well.
  2. Start a Chat, ask the agent to summarise the project. Make sure it reads files correctly.
  3. Run one shell command through the agent. Make sure auto-run (or confirmation) is set the way you expected.
  4. Open a .cursorrules or .cursor/rules/*.mdc file. Make sure the editor still recognises it.
  5. If you use hooks, make a trivial edit to a file the hook matches, and confirm the hook still fires.

If all five work, you're good. If one fails, either it's configuration that needs updating or it's a regression worth rolling back for.

Next moves

On this page