Cursor Basics
Cursor Ask vs Agent vs Composer: The Mental Model
Ask, Agent, Plan and Debug are four agent modes. Switching mode changes the toolset the agent is allowed to use, not the model behind it. Ask is read-only Q&A; Agent edits files and runs commands; Plan researches and writes an editable plan; Debug investigates failures. Composer is a separate thing entirely: a fast, purpose-built model (Composer 2.5) you pick on a different axis, not a mode.
On this page
What's the difference between Ask, Agent, Plan and Debug?
Ask, Agent, Plan and Debug are modes. They all run on the model you picked. Switching mode swaps the toolset the agent can reach for; the underlying model stays put. Pick the mode by how much you want the agent to do.
Interactive diagram. Tab through its regions; each focused region shows its detail in the panel below.
Two independent choices: which tools the agent can use, and which model runs them.
Read the diagram as two columns you set independently. Left is the mode dropdown, which decides what the agent is allowed to touch. Right is the model picker: it decides which model reasons about the problem and writes the code. Set each one separately; they don't move together. The table below spells out what each mode can and can't do.
- Mode
- Ask
- Edits code?
- No (read-only)
- Tools available
- Read + search only
- Best for
- Understanding a codebase, answering questions
- Mode
- Plan
- Edits code?
- No (writes a plan, not edits)
- Tools available
- Read + search; writes an editable plan
- Best for
- Scoping a non-trivial task before any code changes
- Mode
- Agent
- Edits code?
- Yes, multi-file + terminal
- Tools available
- Full read/write/edit + run commands
- Best for
- Implementing features, refactors, fixing across files
- Mode
- Debug
- Edits code?
- Yes, focused
- Tools available
- Read/edit + run + inspect to chase a failure
- Best for
- Reproducing and fixing a bug or failing test
- Mode
- Inline edit (⌘CtrlK)
- Edits code?
- Yes, in place
- Tools available
- Single-selection edit
- Best for
- One precise change to a selection you're watching
| Mode | Edits code? | Tools available | Best for |
|---|---|---|---|
| Ask | No (read-only) | Read + search only | Understanding a codebase, answering questions |
| Plan | No (writes a plan, not edits) | Read + search; writes an editable plan | Scoping a non-trivial task before any code changes |
| Agent | Yes, multi-file + terminal | Full read/write/edit + run commands | Implementing features, refactors, fixing across files |
| Debug | Yes, focused | Read/edit + run + inspect to chase a failure | Reproducing and fixing a bug or failing test |
| Inline edit (⌘CtrlK) | Yes, in place | Single-selection edit | One precise change to a selection you're watching |
Modes decide what the agent is allowed to do. They don't make it faster or slower. That comes from the model. So if a run feels slow, or a provider is having a bad day, switch the model, not the mode. Model providers do go down. As one field engineer put it, Anthropic models have downtime all the time, and when that happens you switch or fall back to Auto.
Auto is the safe default here because it accounts for which models are actually up. It will take that into consideration of the availability of the model for the one we choose for the task at hand.
One part of that field note has since moved on. As of 2026-07-22, Auto on Teams and Enterprise plans is powered by Cursor Router: a classifier runs on each agent request and routes it by task type and complexity, and what you select is an optimization mode - Cost, Balance or Intelligence - not a model. Cost keeps the previous Auto routing logic and its bundled Auto pricing; Balance and Intelligence bill at the routed model's rate. The router is on by default for Teams plans, and Enterprise admins turn it on from the dashboard.
Older tutorials describe a separate "ComposerCursor's own fast coding model, tuned for the editor and priced well below frontier models; the recommended day-to-day model for executing a plan. Press Enter for the full definition." mode, or treat mode changes as model changes. Both are stale. Today there are four agent modes (Agent, Plan, Debug, Ask), and changing mode changes the tools the agent is allowed to use, not the model running underneath.
ComposerCursor's own fast coding model, tuned for the editor and priced well below frontier models; the recommended day-to-day model for executing a plan. Press Enter for the full definition. is not a mode. It is a fast, purpose-built model (Composer 2.5The current Composer release, better at long-running tasks and at judging when a job needs a light touch versus deep work. Press Enter for the full definition.) that you select on the model picker, a different axis from mode. You can run Composer 2.5 in Agent modeCursor's full-capability mode: the AI can read the codebase, write and edit files, move them and run terminal commands. Contrast with Ask mode, which is read-only. Press Enter for the full definition., or any other model in Agent mode; the two choices are independent.
Newer 3.x builds also add Design ModeA way to point at an element in Cursor's built-in browser and change it directly, instead of describing it in words. Press Enter for the full definition., a visual way to direct the agent from the browser in the Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition. (toggle with ⌘Ctrl⇧D): click an element or draw on the page and the agent edits the code behind it. It is a separate toggle on the browser, not one of the four chat modes.
ComposerCursor's own fast coding model, tuned for the editor and priced well below frontier models; the recommended day-to-day model for executing a plan. Press Enter for the full definition. is Cursor's in-house model, trained specifically on reading and writing code. It is built for execution, not planning. The fast variant is what field engineers reach for during live UI work because it turns prompts into edits and diffs quickly. Don't plan with it. Use a frontier model (GPT-5.x, Opus 4.x) to build the plan, then hand the plan to Composer to execute.
Composer 2Cursor's in-house agentic coding model: frontier-level coding quality at high speed and low cost, built as a software-engineering specialist rather than a general-purpose model. Press Enter for the full definition. won't write poetry, it won't do your taxes, but it will write very good code.
This is covered hands-on in Cursor First Hour — 4 short modules, free to read.
Which one should I use for a given task?
Pick the mode by how much you want the agent to change and how risky that change is. Walk down this list and stop at the first line that matches your task.
Smallest mode that closes the loop
0:32 · narratedRead this demo as text
- You only need to understand search filtering. No edit. Pick Ask. It reads and explains without touching anything.
- A clear two-file rename with an obvious path? Pick Agent. The change is bounded, so Agent just executes it.
- A vague multi-file 'improve search'? Pick Plan. Research first when scope is unclear or wide, then build.
Practice next: Practice this yourself in the hands-on module.
Simulated Cursor 3.12 (macOS, light) — beta educational reconstruction, not the real product.
The underlying models are sharp, but they often don't understand the way you do your work. Plan modeA mode that makes no edits: it researches the codebase and produces an editable plan you review before any code changes. Press Enter for the full definition. is where you fix that: brain-dump the problem and what good looks like, let the agent research the docs and codebase and write a step-by-step plan in Markdown, correct anything that's off, then let it execute and test on a few examples. Most of the value is in dumping context and iterating on the approach before a single file changes. Full walkthrough: plan mode in depth.
You can switch both mode and model mid-conversation in the same chat (⇧⇥ rotates modes, ⌘. opens the mode menu), so it's normal to plan with a frontier model, then drop to ComposerCursor's own fast coding model, tuned for the editor and priced well below frontier models; the recommended day-to-day model for executing a plan. Press Enter for the full definition. and hit build without starting over.
- 1Just need to understand something? → Ask mode (read-only, no diffs to review).
- 2One small, known change in a file you have open? → Inline edit (⌘CtrlK).
- 3Chasing a bug or a failing test? → Debug mode.
- 4A change that spans files or needs commands run? → Agent mode.
- 5Big or risky task? → Plan mode first: it researches and writes an editable plan with no code changes, you review it, then switch to Agent to execute.
Whole disciplines live mostly in one mode. If your day is research and understanding rather than shipping edits (support, onboarding onto an unfamiliar codebase, answering a security questionnaire against your own repo), Ask is the efficient default. It gives you semantic search and codebase understanding with no write, edit or terminal access, so you get the answer without burning tokens on a full agent run or risking an unwanted change. Pair it with a cost-effective model and it lands the same answer Agent would.
Since Cursor 3Cursor's agent-forward interface (also called the agent window or Glass), built to run and supervise many agents at once rather than edit one file. Press Enter for the full definition..11 you also don't have to choose between asking a question and letting a long agent run finish: side chats open a parallel thread for questions and tangents without interrupting the main agent conversation.
Ask gates the agent from writing code, generating code or making tool calls in any way. It is a no-write workspace by your own choice, not an access control. Every user has both Ask and Agent; there's no setting that forces a person into Ask-only. What actually protects the codebase is the normal review gate: nothing the agent writes is real until you commit and merge it.
Once I've picked a mode, which model should I run?
Mode and model are separate dials, so picking the mode leaves the model open. A clean way to choose: weigh every model on three axes (performance, cost and speed) and accept that different tasks want a different mix. Planning leans on performance. Execution leans on speed. Most teams are cost-insensitive on the thinking step and cost-sensitive on the grind.
Interactive widget. Tab through its controls; the result updates in the panel below as you change them.
Pick the model on the task, not habit: frontier reasoning for the plan, a fast code model for the build, Auto when you'd rather not think about it.
That three-axis view collapses into one habit that shows up in every workshop: plan with the smart model, build with the fast one. Use a high-reasoning frontier model (GPT-5.x, Opus 4.x) to research and write the plan, then switch to ComposerCursor's own fast coding model, tuned for the editor and priced well below frontier models; the recommended day-to-day model for executing a plan. Press Enter for the full definition. to execute it. By the time the plan exists, the hard thinking is done; what you want from execution is speed, and Composer has enough context and juice to carry it out.
Running the most expensive frontier model through the implementation grind is the classic waste. The plan already tells the executor what to do, so a cheaper, faster model finishes the same work for less.
While it is nice and it is cool, it is expensive. Use a high reasoning model for working with Cursor on the plan, then use a simpler cheaper model for implementation.
The split also covers non-code work. ComposerCursor's own fast coding model, tuned for the editor and priced well below frontier models; the recommended day-to-day model for executing a plan. Press Enter for the full definition. is engineering-tuned, so it shines on data and analytical tasks like queries and reconciliations. For prose (an accounting memo, a write-up), a general-purpose model fits better. If you'd rather not pick per task, run Auto: on Teams and Enterprise plans the router classifies each request by task type and complexity and picks the model for you.
Why do people find these modes confusing?
The usual mix-up is treating mode and model as the same dial. They aren't. Mode changes which tools the agent can touch; the model picker changes which AI runs. The ComposerCursor's own fast coding model, tuned for the editor and priced well below frontier models; the recommended day-to-day model for executing a plan. Press Enter for the full definition. name makes it worse, because it sounds like a mode but is actually a model. And most beginners just default to Agent, even for questions where Ask is safer and faster. The fix is the decision model above: pick the mode by the task's blast radiusHow much breaks if a change goes wrong; the scope of potential damage. Press Enter for the full definition., and treat the model picker as a separate choice.
Frequently asked questions
Is Composer a mode or a model?
A model. Composer (Composer 2.5) is a fast, purpose-built model you pick on the model picker. It is not one of the agent modes. You choose a mode (Ask/Agent/Plan/Debug) and a model independently. You can run Composer 2.5 in Agent mode, for example.
What's the difference between Plan and Ask mode?
Plan mode researches the task and writes an editable plan, but makes no code edits. You review and adjust the plan before any execution. Ask mode is read-only Q&A: it explains and answers but neither edits code nor produces a plan.
Does changing mode change the model?
No. Changing mode changes the toolset the agent is allowed to use: read-only, plan-writing, full edit/terminal, and so on. The model running underneath stays whatever you picked in the model selector.
Can the Agent run terminal commands?
Yes. In Agent mode it can run commands (installing packages, running tests) and apply multi-file edits, then surface diffs and command output for you to approve.
Is Ask mode safe to use on any repo?
Yes. Ask is read-only. It explains and answers without changing files, which makes it the safe default for exploring an unfamiliar codebase. Note that Ask is a convenience, not an access control: every user has Agent too, and there's no setting that locks someone into Ask-only. The real guardrail is the commit and merge review.
Are all the modes available outside the Cursor desktop app?
Not yet everywhere. The JetBrains/IntelliJ integration offers Ask, Plan and Agent, but Debug mode isn't there yet. Cursor is working with JetBrains to add it. You can still switch both mode and model mid-conversation in the same chat.
Sources & last verified
- Cursor Docs - Plan Mode
- Cursor Docs - Debug Mode
- Cursor Docs - Keyboard Shortcuts
- Cursor - Changelog
- Cursor Docs - Cursor Router
Cursor ships frequently. Last updated July 27, 2026.
Keep reading
Rather do it than read about it? Run 11 interactive Cursor walkthroughs in a simulated editor. Free, no account needed.