Cursor Commands & Shortcuts
Reference for Cursor editor keyboard shortcuts, @ mentions, AI features, and settings. Filter by category and copy with one click.
Last updated:
How to Use
Expand how to useCollapse how to use
- 1
Filter by category
Switch between Shortcuts, Command Palette, AI Features, and Settings to find what you need quickly.
- 2
Search details
Use keyword search to match command names, key points, and example descriptions at once.
- 3
Copy and use
Copy commands or shortcuts with one click to use in your settings or cheat sheets.
Latest Updates
Check the latest Cursor version information
Canvases (2026-04-15)
Cursor agents can now respond with interactive canvases—durable artifacts that combine first-party components like tables, diagrams, and charts to build dashboards and custom UIs, pinned in the Agents Window side panel.
Cursor 3.1 (2026-04-13)
A minor update that refines the Agents Window with tiled layouts for parallel agent management, hold-to-speak voice input via Ctrl+M, batch STT processing, and keyboard-navigable Design Mode.
Shortcuts
Command Palette
@Files & Folders
Key points
- Type / after a folder name to expand subfolders.
- Navigate candidates with arrow keys; press Enter to select.
Examples
@src/components/Header.tsxAdd a specific file to AI context@Code
Key points
- More granular than @Files.
- Directly specify functions or classes.
Examples
@handleSubmitAdd a specific function to context@Docs
Key points
- In addition to built-in docs, you can add your own URLs.
- Use the "Add new doc" option to register new documentation URLs.
Examples
@Docs → Next.jsReference the Next.js documentation@Git
Key points
- Useful when asking about recent changes or review context.
- Lets the model reason about repository history without pasting diffs manually.
Examples
@Git → "Summarize what changed on this branch"Ask Cursor to explain the current Git state@Web
Key points
- Useful for release notes, API references, and third-party documentation.
- Use when internal project files are not enough context.
Examples
@Web https://docs.cursor.comBring an external documentation page into the conversation@Cursor Rules
Key points
- Useful when asking the agent to follow or explain repository-specific rules.
- Surfaces rule context without manually copying rule files into the prompt.
Examples
@Cursor RulesInclude active rule context in the current conversation@Past Chats
Key points
- Useful for carrying over decisions and discussions from previous conversations.
Examples
@Past ChatsReference previous chat content to continue work/summarize
Key points
- Use when context runs low in long conversations.
- Auto-compression also occurs, but this allows explicit manual execution.
Examples
/summarizeCompress a long conversation to continue efficiently/commit
Key points
- Custom command: can be defined in .cursor/commands/commit.md.
- Can be combined with /pr.
Examples
/commitAI analyzes changes and suggests a commit message/pr
Key points
- Custom command: can be defined in .cursor/commands/pr.md.
- Can be used with /commit: /commit and /pr
Examples
/commit and /pr these changes to address DX-523Create a commit and PR simultaneously.cursor/commands/*.md
Key points
- Project-level: .cursor/commands/*.md
- Global: ~/.cursor/commands/*.md
- Team: Created via Cursor Dashboard (Team/Enterprise plans).
Examples
.cursor/commands/code-review.mdCreate a custom code review command/create-rule
Key points
- Auto-generates rule files under .cursor/rules/.
- Creates files with frontmatter (alwaysApply, globs, etc.).
Examples
/create-ruleGenerate a new Cursor rule file from chat/migrate-to-skills
Key points
- Automatically converts rules with 'Apply Intelligently' configuration.
- Preserves original behavior patterns when migrating slash commands.
Examples
/migrate-to-skillsBatch-convert existing rules to skill format/worktree
Key points
- Agent works in an independent worktree, keeping your main code safe
- Ideal for parallel branch work and experimental changes
Examples
/worktreeRun agent in an isolated git worktree/best-of-n
Key points
- Compare outputs from multiple models simultaneously
- Useful for comparing code generation and refactoring quality
Examples
/best-of-nRun parallel generation across models and compare resultsAI Features
Agent
Key points
- Launch with Cmd I. Best for complex features and refactoring.
- Tools: Semantic Search, file read/write, shell execution, browser, image generation, etc.
- Checkpoints automatically save state before changes.
Examples
Cmd I → "Add authentication"Have Agent implement a feature across multiple filesAsk
Key points
- Switch with Cmd . → Ask.
- Best for learning, planning, and understanding code.
- Only search tools available (edit tools disabled).
Examples
Cmd . → Ask → "How does this function work?"Understand code without making changesManual
Key points
- Switch via Cmd . → Manual.
- Helpful for review-style conversations and cautious step-by-step changes.
- Reduces autonomous actions and keeps you in the loop.
Examples
Cmd . → Manual → "First outline the change plan only"Review the approach before implementation startsCustom Modes
Key points
- Open Cmd . to select an existing custom mode or create a new one.
- Useful for review-only, docs-only, or team-specific workflows.
- Each mode can define its own instructions and available tools.
Examples
Cmd . → Custom Modes → "Review"Switch to a dedicated review modeTab Completion
Key points
- Shows ghost text (additions) or diff popups (modifications).
- Tab: accept. Escape: reject. Cmd →: accept one word at a time.
- Jump in file: auto-moves to next edit location after accepting.
- Jump across files: portal window suggests edits in other files.
Examples
Tab → Tab (jump)Accept suggestion and auto-jump to the next edit locationInline Edit (Cmd K)
Key points
- Select code then Cmd K to enter edit instructions.
- Opt Return: ask a question without editing.
- On empty files, can generate the entire file.
Examples
Cmd K → "Add TypeScript types"Add TypeScript type annotations to selected codeMemories
Key points
- Useful for coding style, recurring constraints, and preferred workflows.
- Can be used by agents and automations to stay consistent across sessions.
Examples
Save memory: "Use pnpm in this repository"Persist a project preference for later tasksParallel Agents
Key points
- Best-of-N: send the same prompt to multiple models simultaneously and compare.
- Apply button merges worktree changes back to the main branch.
- Up to 20 worktrees per workspace.
Examples
Launch multiple Agents → Apply best resultCompare parallel implementations and choose the best oneCheckpoints
Key points
- Auto-saved each time the Agent makes changes.
- "Restore Checkpoint" button to revert to any point.
Examples
Restore CheckpointRevert Agent changes to a previous stateReview (Find Issues)
Key points
- Review option appears automatically after Agent finishes.
- Detects code quality, bugs, and security issues.
Examples
Find IssuesDetect issues in the Agent's changesBugbot
Key points
- Finds likely bugs, regressions, and quality issues in PRs.
- Can suggest direct fixes from the review findings.
Examples
Bugbot → AutofixTurn a Bugbot finding into an immediate fix suggestionTerminal Cmd K
Key points
- Cmd Return: execute the generated command.
- Escape: accept command into shell (without running).
Examples
Terminal → Cmd K → "Search logs from last 3 days"Generate shell commands from natural languageCloud Agents
Key points
- Launch from cursor.com dashboard or via API.
- Computer Use: browser automation, screenshots, and video recording in isolated VMs.
- Bugbot Autofix: detects issues in PRs and auto-proposes fixes (35%+ merge rate).
Examples
cursor.com → Cloud Agents → New AgentLaunch a cloud agent to auto-generate PRsBackground Agents
Key points
- Useful when a task takes too long for an interactive foreground session.
- Pairs naturally with cloud execution and automations.
Examples
Start a background agent to investigate flaky testsOffload a long-running task to an async agentAutomations
Key points
- Triggers: schedule (cron), GitHub PR/push, Slack messages, Linear issues, PagerDuty incidents, webhooks.
- Tools: open PR, comment, request reviewers, send to Slack, MCP, Memories, and more.
- Permissions: Private / Team Visible / Team Owned.
Examples
cursor.com/automations/newCreate a new automation for event-driven tasksSubagents
Key points
- Built-in subagents: Explore (code search), Bash (shell execution), Browser (browser control).
- Two modes: foreground (blocks until done) and background (returns immediately).
- Custom subagents can have dedicated prompts, tools, and models.
Examples
Agent → delegate research to subagentOffload large codebase exploration to keep the main conversation focusedMCP Apps
Key points
- Displays partner UIs from Amplitude, Figma, tldraw, and more directly inside Cursor.
- MCP tools can return interactive UI alongside standard tool output.
Examples
MCP Apps → view diagram in tldrawView interactive diagrams during a chat sessionAgents Window
Key points
- Open via Cmd Shift P → 'Agents Window'
- Can be used alongside the traditional IDE view; switch back anytime.
- Run multiple agents across repositories and environments simultaneously
Examples
Cmd Shift P → Agents WindowOpen Agents Window to run multiple agents in parallelDesign Mode
Key points
- ⌘+Shift+D: toggle Design Mode
- Shift+drag: select an area
- ⌘+L: add element to chat, ⌥+click: add element to input
Examples
⌘+Shift+DToggle Design Mode to directly target UI elementsAgent Tabs
Key points
- Display multiple chats simultaneously for parallel work
- Switch between side-by-side and grid layouts
Examples
Agent TabsView multiple agent chats at once in a gridTiled Layout
Key points
- Split the current view into panes to manage several agents at once
- Drag agents between tiles to rearrange them on the fly
- Use keybindings to quickly navigate between tiles
Examples
Tiled LayoutSplit the Agents Window into tiles and run multiple agents in parallelSettings
.cursor/rules/*.md
Key points
- Location: .cursor/rules/*.md or .cursor/rules/*.mdc
- Apply types: Always Apply, Apply Intelligently, specific files only, manual.
- Use frontmatter to set alwaysApply: true or globs patterns.
Examples
.cursor/rules/coding-standards.mdDefine coding standards as a rule fileUser Rules
Key points
- Location: Cursor Settings → Rules
- Project rules take precedence (Team > Project > User).
Examples
Cmd Shift J → RulesConfigure global rulesAGENTS.md
Key points
- Write rules in Markdown format.
- Functional alternative to .cursor/rules.
- .cursorrules (legacy) is still supported.
Examples
AGENTS.mdPlace AI rules at the project rootGenerate Cursor Rules
Key points
- Useful for bootstrapping `.cursor/rules` from the current repository style.
- Can help turn team conventions into reusable Cursor rules.
Examples
Cmd Shift P → Generate Cursor RulesCreate new Cursor rule files from repository contextAuto-Run Mode
Key points
- Modes: Run in Sandbox / Ask Every Time / Run Everything
- Network access: sandbox.json only / defaults included / allow all.
- Protections: browser auto-run, file deletion, dotfile, and external file protection.
Examples
Cmd Shift J → Agents → Auto-RunChange command auto-execution security settingsTab Settings
Key points
- Partial Accepts: accept one word at a time with Cmd →.
- Toggle suggestions in comments, whitespace-only suggestions, auto-import (TypeScript/Python).
- Status bar: snooze, disable globally, or disable for specific file extensions.
Examples
Cmd Shift J → TabOpen Tab completion detailed settings.cursorignore
Key points
- Location: .cursorignore in project root.
- Same pattern syntax as .gitignore.
- Exclude sensitive files or binaries from AI.
Examples
.cursorignore → .env*Exclude environment variable files from AI indexingMCP Servers
Key points
- Location: Cursor Settings → MCP, or .cursor/mcp.json
- Configure MCP tool allowlists for sandbox execution.
Examples
.cursor/mcp.jsonConfigure project-specific MCP servers.cursor/worktrees.json
Key points
- Location: .cursor/worktrees.json
- Setting: cursor.worktreeCleanupIntervalHours (cleanup interval).
- cursor.worktreeMaxCount: max worktrees per workspace (default 20).
Examples
.cursor/worktrees.jsonDefine worktree setup scripts.cursor/skills/
Key points
- Locations: .agents/skills/, .cursor/skills/, ~/.cursor/skills/
- SKILL.md contains metadata (name, description) and documentation.
- Invoke manually with /skill-name or let the agent use it automatically.
Examples
.cursor/skills/code-review/SKILL.mdCreate a custom code review skill.cursor/hooks.json
Key points
- Locations: .cursor/hooks.json (project), ~/.cursor/hooks.json (user)
- Events: sessionStart/End, preToolUse/postToolUse, beforeShellExecution, and more.
- Two types: command-based (shell scripts) or prompt-based (LLM-evaluated).
Examples
.cursor/hooks.json → preToolUseRun a security check before each tool executionPlugins
Key points
- Manifest: .cursor-plugin/plugin.json (name field required).
- Published on Cursor Marketplace. Team/Enterprise can use private marketplaces.
- All marketplace plugins undergo security review before listing.
Examples
.cursor-plugin/plugin.jsonDefine a custom plugin manifestTeam Rules
Key points
- Configured from the Cursor dashboard.
- Precedence: Team Rules > Project Rules > User Rules.
Examples
cursor.com → Team RulesSet AI rules for the entire teamcursor agent
Key points
- cursor agent: start interactive session. cursor agent "prompt": start with initial instruction.
- cursor agent ls: list past conversations. cursor agent resume: continue latest session.
- cursor agent -c: run in cloud mode. Supports headless and CI execution.
Examples
cursor agent "Add authentication"Launch an AI agent from CLI to execute a taskVersion Updates
Major Cursor version updates and new features.
Cursor agents can now respond with interactive canvases—durable artifacts that combine first-party components like tables, diagrams, and charts to build dashboards and custom UIs, pinned in the Agents Window side panel.
Canvaseslet agents respond with interactive visual artifacts instead of plain text- Built-in first-party components: tables, boxes, diagrams, and charts can be composed on a single canvas
- Seamlessly integrates with existing Cursor surfaces such as diffs and to-do lists
- Generated canvases persist in the Agents Window side panel so you can revisit them later
- Available in Cursor 3.1 across the Agents Window and the editor
A minor update that refines the Agents Window with tiled layouts for parallel agent management, hold-to-speak voice input via Ctrl+M, batch STT processing, and keyboard-navigable Design Mode.
Tiled Layoutsplits the Agents Window into panes so multiple agents can run and be managed in parallelCtrl+Mcaptures voice input while held and transcribes it with batch STT when released- Design Mode now supports navigating the element tree (up, down, sideways) from the keyboard
- Search and select a branch from the empty state before launching a cloud agent
- Jump straight from a diff to the matching line in the file, plus include/exclude filters in Search in Files
Bugbot now learns from pull-request feedback and turns those signals into rules, gains MCP server support for richer review context, and ships a Fix All action. Resolution rate reaches an all-time high of 78%.
Learned Ruleslet Bugbot self-improve in real time from pull-request feedbackBugbot MCP Supportgives reviews access to MCP servers for additional contextFix Allapplies multiple Bugbot fixes in a single operation- Improvements to Bugbot Autofix push the resolution rate to 78%
A new agent-centric interface with Agents Window, Design Mode, Agent Tabs, and /worktree and /best-of-n commands. Run agents in parallel across environments.
Agents Windowruns multiple agents in parallel across local, worktree, cloud, and remote SSH environmentsDesign Modeannotates and targets UI elements directly in the browser for precise agent feedbackAgent Tabsdisplays multiple chats side-by-side or in a grid layout within the editor/worktreecommand for isolated git worktree execution,/best-of-nfor parallel multi-model comparison- New
Awaittool for agents, enhanced screenshot-based browser automation
Self-hosted Cloud Agents keep your code and tool execution entirely in your own network. Full Cloud Agent capabilities with isolated VMs and plugins, without sending code externally.
Self-hosted Cloud Agentskeep code and tool execution on your own infrastructure- Codebase and secrets remain within your internal network
- Same capabilities as hosted agents including isolated VMs and plugins
Adds Composer 2, a new AI model with frontier-level coding performance and strong results on challenging coding tasks in CursorBench.
- New
Composer 2model delivers frontier-level coding performance - Strong results on challenging coding tasks measured by CursorBench benchmarks
- Two pricing tiers: Standard ($0.50/M input, $2.50/M output) and Fast ($1.50/M input, $7.50/M output)
Adds more than 30 new Marketplace plugins, expanding integrations for Atlassian, Datadog, GitLab, Hugging Face, PlanetScale, and more.
- Adds 30+ new Marketplace integrations
- Includes Atlassian, Datadog, GitLab, Hugging Face, PlanetScale, and other major services
- Makes it easier to connect external tools and data sources from inside Cursor
Introduces always-on trigger-based agents. Cloud agents run automatically in response to GitHub, Slack, Linear, PagerDuty, and webhook events.
Automationsruns cloud agents on schedules or event triggers- Triggers: GitHub PR/push, Slack messages, Linear issues, PagerDuty incidents, webhooks
- Tools: PR creation, comments, reviewer requests, Slack messages, MCP, Memories
- Can be created in one click from Marketplace templates
Cursor is now available in IntelliJ IDEA, PyCharm, and WebStorm via Agent Client Protocol.
- Use Cursor AI features inside IntelliJ IDEA, PyCharm, and WebStorm
- Integrated through Agent Client Protocol
- Supports OpenAI, Anthropic, Google, and Cursor models
MCP Apps bring interactive charts, diagrams, and whiteboards into Cursor. Team Marketplaces allow private plugin sharing.
MCP Appsembeds interactive UI from Amplitude, Figma, tldraw, and more inside CursorTeam Marketplacesallows private plugin sharing for Teams and Enterprise plans- Support for parallel Debug sessions
- Debug mode automatically removes unneeded code between turns and adjusts logging dynamically
- Browser tool adds context menus and zoom support
Adds one-click autofix suggestions for issues Bugbot finds on pull requests.
- Run Autofix directly from Bugbot findings
- Review and apply fix suggestions while staying in the PR flow
- Cuts the back-and-forth between review and remediation
Introduces the plugin system and Cursor Marketplace. Adds async subagents and sandbox network controls.
Pluginsand Cursor Marketplace for installing and managing extensionsAsync Subagentssupports background execution and nesting of subagentsLong-Running Agentsbecomes available as a research previewSandbox Network Controlsadds domain-level network access controls- CLI improvements: Plan Mode menu and terminal Mermaid ASCII rendering
About Cursor Commands & Shortcuts
A searchable reference covering the full surface of Cursor editor — keyboard shortcuts, AI mode switching (Agent, Ask, Manual, Custom), @ mention context syntax, slash commands, .cursorrules configuration, and MCP integration. Organized by category based on Cursor's official documentation, with version update notes included. Filter, search, and copy any command in one click without leaving your current context.
Features
- Comprehensive coverage of shortcuts, @ mentions, AI features, and settings
- Category filters and text search for quick access
- One-click copy for instant reference
- Accurate reference based on Cursor official documentation
- Version update information included
Use Cases
- Looking up the right keyboard shortcut (Cmd I vs Cmd K vs Cmd L) when you keep opening the wrong Cursor panel mid-coding session
- Deciding which mode to use — Agent, Ask, Manual, or Custom — before starting a complex refactoring task across multiple files
- Checking the correct @ mention syntax (@file, @folder, @web, @docs, @git) to give Cursor context without pasting code manually
- Creating a team .cursorrules file and referencing this guide to ensure everyone on the project uses consistent AI behavior
- Onboarding a VS Code user to Cursor by showing them which shortcuts carry over and which new ones (Cmd I, Cmd .) they need to learn
FAQ
Are Cursor shortcuts the same as VS Code?
Cursor is a VS Code fork, so all VS Code shortcuts work unchanged. Cursor adds its own AI shortcuts on top: Cmd I (open Agent), Cmd K (inline edit), Cmd L (open chat), and Cmd . (switch modes). Everything else behaves exactly as in VS Code.
What is the difference between Agent, Ask, Manual, and Custom Modes?
Agent autonomously reads files, writes code, and runs terminal commands. Ask is read-only — great for questions and explanations without touching files. Manual pauses for your approval between each step. Custom Modes let you define your own instruction set and tool permissions for a specific workflow (e.g., a dedicated code-review mode).
What are the Windows and Linux equivalents of Mac shortcuts?
Replace Cmd with Ctrl and Opt with Alt. For example: Cmd I → Ctrl I, Cmd K → Ctrl K, Cmd Shift P → Ctrl Shift P. All keybindings are customizable via Ctrl Shift P → 'Keyboard Shortcuts'.
What is .cursorrules and should I commit it?
.cursorrules is a project-level file where you define coding conventions, preferred libraries, and custom instructions for Cursor. Yes, commit it to your repo — every teammate will then get consistent AI suggestions without manual configuration.
How do I create custom slash commands in Cursor?
Create Markdown files in the .cursor/commands/ directory. The filename becomes the slash command name, and the file content is used as the prompt template. For user-global commands (shared across all projects), place them in ~/.cursor/commands/.
How does Cursor compare to GitHub Copilot?
Cursor's Agent mode can autonomously edit multiple files, run shell commands, and iterate based on test output — going beyond Copilot's inline completion. Copilot is available directly inside VS Code without switching editors, but Cursor's multi-file agent is significantly more powerful for complex refactoring tasks.
