Overview

Natural language interface for exploring, editing, and managing code with contextual AI assistance in Chat mode

What is Chat?

Chat (previously “Composer”) is Cursor’s AI assistant that lives in your sidebar, letting you interact with your codebase through natural language. You can ask questions, request code edits, get terminal command suggestions, and more - all without switching context.

Core Capabilities

Understand Code

Ask questions about unfamiliar code, get explanations, or explore your codebase

Edit Code

Make small tweaks or large multi-file changes without manually navigating files

Run Commands

Get terminal command suggestions for your specific use case

Automate workflows

Let Cursor search, reason and execute to automate your workflows

Getting Started

Access Chat in the sidebar with ⌘+L (Mac) or Ctrl+L (Windows/Linux). Type your request in natural language, and the AI will respond accordingly.

What can I do with Chat?

Build features

Chat has the ability to learn your codebase and make changes to it on your behalf. This is a powerful way to implement new features, and is the perfect tool for feature requests.

Simply explain to the chat, using Agent mode, what feature you would like it to implement. Chat will look at your codebase, and any relevant files, and suggest any necessary changes across these fields.

In addition to code edits, Chat may suggest other changes, like adding new files, or adding packages with a package manager.

Refactor code

By leaning into its understanding of your codebase, and how each component fits together, Chat can help you refactor your codebase.

Explain to the chat the current structure of your codebase, and the changes you’d like to make. The agent can read the relevant code, plan its changes, and implement them to make refactors and project restructuring a breeze.

Setup new projects

Chat is excellent at helping you get a new project off the ground!

Tell the chat what kind of project you are wanting to build, and explain any specific requirements you have for the desired technical stack, and the Agent will get to work for you, create the project structure, install the dependencies, and even write the initial code to get you started as quickly as possible.

Modes

Chat offers different modes optimized for specific tasks:

Agent

Allow Cursor to autonomously learn your codebase, and make codebase-wide changes on your behalf

Ask

Get explanations and answers about your codebase, and plan out features with the AI

Manual

Make focused edits, using only the context you provide

Custom Modes

Create custom modes to suit your specific workflows

Switch between modes using the mode picker or ⌘. shortcut to match your current needs.

Context

Chat understands your codebase by analyzing:

1. Open files: What you’re currently viewing
2. @-symbols: Use @-symbols to reference specific code elements
3. Project structure: The organization of your files and dependencies

The interface suggests relevant context based on your query, ensuring accurate responses.

Code Edits

When Chat suggests code changes:

1. Review: See the proposed changes in a diff view
2. Apply: In Ask mode, explicitly apply changes with the “Apply” button
3. Accept/Reject: After changes are made, decide whether to keep or discard them

Cursor’s custom model applies suggested edits to files with thousands of lines in seconds.

Learn More about Apply

Find out more about Cursor’s custom-trained model for applying changes.

Tabs

When using the Chat, you are able to run multiple conversations at once, and switch between them using Tabs.

To do this, simply hit ⌘+T (Mac) or Ctrl+T (Windows/Linux) to create a new tab. Unlike chat history, tabs can be executed in parallel, and are not dependent on the previous request.

Cursor will intelligently track all simultaneous conversations, and allow you to switch between them at any time, while ensuring multiple tabs don’t attempt to make changes to the same files at once.

Checkpoints

Sometimes you may want to revert to a previous state of your codebase. Cursor helps you with this by automatically creating checkpoints of your codebase at each request you make, as well every time the AI makes changes to your codebase.

To revert to a previous state, you can either:

• Click the Restore Checkpoint button that appears within the input box of a previous request, as shown below
• Click the + button that shows at the left of a message in the chat history when hovered

Rules

Cursor comes out the box with a carefully designed set of behaviors, but you can customize Cursor to fit your specific workflows, both in its interactions with you, and how it makes changes to your code.

Learn More about Rules

Learn about Cursor’s “rules” system for customizing AI behavior.

Model Selection

By default, Cursor has an ‘auto-select’ option, which will intelligently select the best premium model for your request. This will always use 1 premium request as is, unless you have certain settings enabled that increase this, like long-context mode.

If you want more granular control over which model is used, you can manually select a model from the model picker.

Learn More about Models

Learn about Cursor’s different AI models and how to switch between them.

When using custom modes, you can also select a fixed model for each mode, such as selecting o1 for a Planning mode.

History and Cost

Chat history has moved to the command palette. You can access it from the “Show history” button in Chat, as well as by running the “Show Chat History” command in the command palette. For models with usage-based pricing, view cost breakdowns by clicking the history icon.

Code Review

Reviewing agent code is now simpler with a built-in diff view at the end of each conversation. You can access it by clicking the Review changes button at the end of a conversation.

Managing Long Conversations

For extended conversations, Cursor summarizes earlier messages using smaller models to maintain speed and relevance without losing context.

When approaching the context window limit, Chat suggests starting a new conversation with reference to the current one.

Questions

What happened to the Composer?

In past versions of Cursor, we had two seperate concepts: the chat, and the composer. The chat was a read-only interface, like the Ask mode, and the composer was what we now call Manual mode. With the addition of the Agent mode, and the idea that the AI was now capable at learning your codebase on its own, we decided to combine the chat and composer into a single interface, and call it Chat.

Can I get notifications when Chat finishes processing?

Yes, enable sound notifications from Settings → Features → Chat → Play sound on finish (Beta feature)

How are long conversations handled?

For long conversations, Cursor summarizes earlier messages with smaller models to maintain responsiveness while preserving key details.

Can I access my conversation history on another computer?

No, conversation history is stored locally and not tied to your Cursor account, so it’s only available on the computer where it was created.

How do I change the default Chat mode?

Set your default mode from Settings → Features → Chat → Default chat mode to your preferred mode or the most recently used one.