Agent

You can delegate tasks to Cursor Agent and let it work alongside you. Agent performs its work in Composer and is built on top of it. Make sure to read about Composer to best work with Agent.

​

Tools

Agent has access to multiple tools, including

• Reading & Writing code
• Searching codebase
• Call MCP servers
• Run terminal commands

The reasoning capabilities of Agent enables some very powerful workflows where it can perform many consecutive actions without much supervision.

​

Terminal

When Agent runs terminal commands, it uses VS Code’s terminal profiles to determine which shell to use. It iterates through the available profiles, starting with the default one, and selects the first profile that supports command detection. This means the shell used by Agent might differ from your default system shell if another compatible terminal profile is found first.

To change which terminal profile is used:

1. Open Command Palette (Cmd/Ctrl+Shift+P)
2. Search for “Terminal: Select Default Profile”
3. Select your preferred terminal profile

​

Yolo mode

With Yolo mode enabled, Agent can execute terminal commands by itself. This especially useful when running test suites. Instruct Agent with a task and how to verify changes (running a test), and it will continue until the task is completed.

​

Guardrails

You can define guardrails and allow/deny lists for certain commands you don’t want Agent to run automatically. This is done from Cursor Settings

​

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

​

Use Agent

Start by opening a new Composer and enable Agent mode. From there, you can give it instructions on what work to perform.

​

Models

You can use claude-3.5-sonnet, gpt-4o and o3-mini with Agent today. We’ll be adding more models soon!

​

FAQ

​

What’s the difference betweet Agent and Composer?

You can toggle between Normal and Agent mode in Composer. The main difference is that Agent will think harder, use reasoning and tools to solve problems thrown at it. Normal composer doesn’t have access to tools, only managing code.