Manual Mode
Make precise code changes with explicit file targeting - a focused editing mode with user-controlled tooling
Manual mode is designed for making targeted code modifications when you know exactly what changes are needed and where.
Unlike Agent mode, it does not explore the codebase or run terminal commands; it relies entirely on your specific instructions and the context you provide (e.g., via @
-mentioning files).
Manual’s Capabilities
Precise Editing
Applies specific code changes exactly as instructed by the user.
Direct Instruction
Follows user commands without autonomous exploration or planning.
Multi-File Edits
Can make coordinated changes across multiple specified files.
Focused Toolset
Primarily uses file editing capabilities; lacks search and terminal tools.
Make sure to read chat overview to learn more about how modes work in Cursor.
Using Manual Mode
Manual mode allows for a more precise and targeted approach to code editing. It is designed for making targeted code modifications when you know exactly what changes are needed and where.
To make use of Manual mode, you need to explicitly mention the files you want to edit using the @
symbol.
🧠 Understand Request
Create your request as you normally would in the chat.
🔍 Explore Codebase
Add context to your request by mentioning the files you want to edit using the @
symbol.
📝 Plan Changes
After applying, you can review the changes. Manual mode may flag potential issues if linters are configured.
🔧 Execute Changes
Once edits are applied, the task is considered complete.
Manual mode excels when you need control and precision, acting as an AI pair programmer executing your specific plan. Provide clear context and instructions for best results.
Example Use Cases
Provide explicit file paths (using @
) and clear descriptions of the changes you want.
Refactoring Specific Functions
“In @src/utils/helpers.ts and @src/components/UserProfile.tsx,rename the function getUserData
to fetchUserProfile
and update all call sites within these files.”
Manual mode will:
- Locate
getUserData
function definitions and calls only within the specified files. - Rename the function and update the call sites as instructed.
Applying Boilerplate
“Add the standard copyright header comment to the top of @src/newModule.js and @src/newService.java”
Manual mode will:
- Open the specified files.
- Insert the provided header comment at the beginning of each file.
Configuration Options
- Select a Model: Pre-select a model specifically for Manual mode.
- Edit Keybindings: Set custom keybindings to quickly activate Manual mode.
- Available Tools: Manual mode primarily uses the file editing tool. Search and terminal tools are disabled.
Was this page helpful?