Cursor Documentation
  1. Chat
Cursor Documentation
  • Get Started
    • Introduction
    • Installation
    • FAQ
  • Guides
    • Editor Migration
      • Migrate from VS Code
      • Migrate from JetBrains IDEs
    • Languages & Frameworks
      • JavaScript & TypeScript
      • iOS & macOS (Swift)
      • Java
  • Editor
    • AI Commit Message
    • Notepads (Beta)
    • Keyboard Shortcuts
    • Tab
      • Overview
      • Tab vs GitHub Copilot
      • Auto-import
      • Advanced Features
    • Chat
      • Overview
      • Agent mode
      • Ask mode
      • Custom modes
      • Tools
      • Apply
    • ⌘K
      • Overview
      • Terminal Cmd K
  • Context
    • Codebase Indexing
    • Rules for AI
    • Ignore Files
    • Model Context Protocol
    • @ Symbols
      • Overview
      • @Files
      • @Folders
      • @Code
      • @Docs
      • @Git
      • @Web
      • @Definitions
      • @Link
      • @Lint Errors
      • @Lint Errors
      • @Recent Changes
      • @Cursor Rules
      • @Notepads
      • @Summarized Composers
      • #Files
      • /command
  • Account
    • Plans & Usage
    • Dashboard
    • Billing
    • Business
      • Get Started
      • Members + Roles
      • Analytics
      • SSO
  • Settings
    • Models
    • Custom API Keys
    • Early Access Program
  • Troubleshooting
    • Common Issues
    • Troubleshooting Guide
    • Getting a Request ID
  1. Chat

Overview

Chat is where you can ask questions, do small and large multi-file edits and run agents
Overview.gif

Tools#

Chat has a range of tools that you can use to help you search, edit and run commands. Read more about the tools in tools

Modes#

You can switch between modes during a conversation using the mode picker or ⌘. shortcut. This flexibility lets you adapt to your current needs - from asking questions to making changes to using advanced tools.

Models#

Each mode can have a preselected model that will be used when the mode is selected. You can always change the model from the model picker.

Shortcuts#

Each mode has a default shortcut that you can change from the mode picker.

Pre-defined modes#

Agent#

Access tools and reasoning capabilities for complex tasks

Ask#

Ask questions about your code, get explanations, and discover your codebase

Manual#

Make single-turn edits with context provided manually by you.

Custom modes#

You can create custom modes that you can select from the mode picker.

Default mode#

You can set the default mode from settings (Settings → Features → Chat → Default chat mode) to one of your modes or the one you use most recently

Context#

You can use @-symbols to include relevant context in your prompts. The interface will automatically suggest relevant context based on your query.

Checkpoints#

For every iteration a checkpoint is created. You can return to any previous version by clicking on checkout near that checkpoint. This is handy if you don’t like the current changes and want to revert to an earlier state.
Checkpoints

Chat History#

Access previous conversations through the history. Open it from the history icon to the right of Cursor Tab. You’ll see a list of past conversations which you can revisit, rename, or remove.
Open with ⌘+⌥+L or Ctrl+Alt+L when the interface is focused.
History Icon

Sound notification#

Play a sound when a conversation is finished to let you know it’s done. This can be useful when you have multiple conversations running and want to know when one is finished.
Beta feature. You can enable sound notifications from Settings → Features → Chat → Play sound on finish

Long conversations#

For long conversations, Cursor summarizes earlier messages with smaller models like cursor-small and gpt-4o-mini to keep responses fast and relevant. This approach helps ensure that even extended conversations remain responsive and coherent, without losing track of key details from earlier exchanges.
When a conversation starts to reach the context window limit, we’ll show a suggestion to start a new Chat with reference to the current one
New Chat Suggestion

Generating & Applying Changes#

Cursor has a custom model trained in-house that is able to take a series of edits, as suggested by the AI model you are using, and apply it to files with 1000s of lines in seconds.
This happens automatically in all modes
In Ask mode, you can apply changes by clicking the Apply button in the bottom right of the diff view.
Once your changes have been made, you can review them inside your codebase, and then choose to accept or reject them, if you’d like to interate further.
Learn More about ApplyFind out more about applying changes with Cursor’s custom trained model.

Rules#

You can direct the Agent with rules. They can auto attached to any Agent request based on glob patterns, or the Agent can grab one based on the rule description.
Read more about how you can work with rules

Cost#

You can find the cost breakdown per chat for models with usage based pricing by clicking the history icon in the top right of the chat.
Chat Cost

Feedback#

Give feedback with thumbs up and down buttons as well as free form text. This will help us improve the quality of the output

Layout#

Pane: A sidebar with the interface on the left and your code editor on the right.
Editor: A single editor window, similar to viewing code normally. You can move it around, split it, or even place it in a separate window.
Floating: A draggable window that you can position where you like
You can change this from the menu → Open as [layout]

FAQ#

How are long conversations handled?#

For long conversations, Cursor summarizes earlier messages with smaller models like cursor-small and gpt-4o-mini to keep responses fast and relevant.
This approach helps ensure that even extended conversations remain responsive and coherent, without losing track of key details from earlier exchanges.

Can I access my conversation history on another computer?#

Conversation history is stored locally on your computer and is not stored on Cursor’s servers or tied to your Cursor account.
This means if you switch to a different computer, you won’t have access to your previous history. You can only access your history on the computer where it was originally created.
Modified at 2025-03-31 02:57:19
Previous
Advanced Features
Next
Agent mode
Built with