Agent offers different modes optimized for specific tasks. Each mode has different capabilities and tools enabled to match your workflow needs.
ModeForCapabilitiesTools
AgentComplex features, refactoringAutonomous exploration, multi-file editsAll tools enabled
AskLearning, planning, questionsRead-only exploration, no automatic changesSearch tools only
CustomSpecialized workflowsUser-defined capabilitiesConfigurable

​
Agent

The default mode for complex coding tasks. Agent autonomously explores your codebase, edits multiple files, runs commands, and fixes errors to complete your requests.

​
Ask

Read-only mode for learning and exploration. Ask searches your codebase and provides answers without making any changes - perfect for understanding code before modifying it.

​
Custom

Create your own modes with specific tool combinations and instructions. Mix and match capabilities to fit your workflow.
Custom modes are in beta. Enable them in Cursor Settings → Chat → Custom Modes

​
Examples

​
Switching modes

  • Use the mode picker dropdown in Agent
  • Press Ctrl+. for quick switching
  • Set keyboard shortcuts in settings

​
Settings

All modes share common configuration options:
SettingDescription
ModelChoose which AI model to use
Keyboard shortcutsSet shortcuts to switch between modes
Mode-specific settings:
ModeSettingsDescription
AgentAuto-run and Auto-fix ErrorsAutomatically run commands and fix errors
AskSearch CodebaseAutomatically find relevant files
CustomTool selection & InstructionsConfigure tools and custom prompts