Cursor Install & Auth

Install Cursor IDE and authenticate your account. Covers all platforms, plan activation, and VS Code migration.

Installation

macOS

# Option 1: Direct download
open https://cursor.com/download

# Option 2: Homebrew
brew install --cask cursor

After install, drag Cursor.app to Applications. First launch may require: System Settings > Privacy & Security > Allow.

Linux

# Download AppImage
curl -fSL https://download.cursor.com/linux/appImage/x64 -o cursor.AppImage
chmod +x cursor.AppImage
./cursor.AppImage

# Or via .deb (Debian/Ubuntu)
curl -fSL https://download.cursor.com/linux/deb/x64 -o cursor.deb
sudo dpkg -i cursor.deb

Add to PATH for terminal launching:

# Add to ~/.bashrc or ~/.zshrc
alias cursor='/path/to/cursor.AppImage'

Windows

Download installer from cursor.com/download. Run the .exe installer. Cursor installs per-user (no admin required by default).

Authentication

First Launch Sign-In

1. Launch Cursor
2. Click Sign In in the welcome screen
3. Choose auth method:

• GitHub (recommended for developers)
• Google
• Email + password

1. Browser opens for OAuth flow
2. Approve the authorization
3. Return to Cursor -- it detects the auth automatically

Plan Activation

After sign-in, your plan is automatically active:

Upgrade at: cursor.com/settings

VS Code Migration

On first launch, Cursor detects existing VS Code installations and offers one-click import:

What Migrates Automatically

• Settings: settings.json preferences
• Keybindings: Custom keyboard shortcuts
• Extensions: Re-installs compatible extensions from Open VSX Registry
• Themes: Color themes and icon packs
• Snippets: User-defined code snippets

What Does NOT Migrate

• Microsoft-exclusive extensions: GitHub Copilot, Live Share, Remote-SSH (MS marketplace only)
• Extension state: Login states, extension-specific databases
• Workspace trust: Need to re-trust workspaces

Manual Extension Installation

For extensions not in Open VSX, install via .vsix:

1. Download .vsix from VS Code Marketplace website
2. In Cursor: Cmd+Shift+P > Extensions: Install from VSIX...
3. Select the downloaded file

Post-Install Configuration Checklist

[ ] Sign in and verify plan (cursor.com/settings)
[ ] Import VS Code settings (if applicable)
[ ] Set default shell: Cursor Settings > Terminal > Default Profile
[ ] Configure privacy mode: Cursor Settings > General > Privacy Mode
[ ] Set default AI model: Cursor Settings > Models
[ ] Verify Tab completions work: type code, see ghost text
[ ] Verify Chat works: Cmd+L, ask a question
[ ] Install missing extensions from Open VSX

Settings File Locations

Troubleshooting

Enterprise Considerations

• Domain verification: Enterprise admins verify company domain before enabling team features
• Managed deployment: Distribute Cursor via MDM (macOS) or SCCM (Windows) with pre-configured settings
• Offline install: Download the installer package for distribution behind firewalls (auth still requires network)
• SSO bypass: First login can use email/password; SSO enforcement applied after team admin configures SAML

Resources

• Cursor Download
• VS Code Migration Guide
• Pricing
• Account Settings