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
ManualPrecise, targeted editsDirect file editing with explicit controlEdit 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.

Manual

Direct editing mode for precise control. Manual only edits the files you explicitly select - no searching, no commands, just focused changes where you need them.

Manual mode works best when you know exactly what to edit. Select the right files and give clear instructions.

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 SettingsChatCustom 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