[ ABORT TO HUD ]
SEQ. 1
SEQ. 2

Multi-File Composer

🤖 Composer & Agent Mode 20 min 350 BASE XP

Project-Wide AI Editing

The Composer (Ctrl+I) is Cursor's most powerful feature. Unlike Chat (which explains) or Inline Edit (which modifies one file), Composer can create, modify, and delete multiple files simultaneously based on natural language instructions.

Normal vs Agent Mode

ModeCapabilitiesOversight
Normal ComposerMulti-file edits based on your promptYou review and apply each change
Agent ModeAutonomous planning, file creation, terminal commands, iterationAI decides what to do and executes

Example Prompt

Create a REST API endpoint for user authentication with:
- POST /api/auth/login with JWT tokens
- POST /api/auth/register with validation
- Middleware for protected routes
- Unit tests for all endpoints

In Normal mode, Composer generates the files and shows diffs for approval. In Agent mode, it also runs npm install jsonwebtoken, creates the files, runs the tests, and fixes any failures — all autonomously.

Best Practice: Always git commit before running Agent mode on complex tasks. This gives you a clean rollback point if the agent goes in the wrong direction.
SYNAPSE VERIFICATION
QUERY 1 // 3
What is the key difference between Normal Composer and Agent Mode?
Agent Mode is faster
Agent Mode can autonomously run terminal commands and iterate on failures
They are the same thing
Normal Composer supports more models
Watch: 139x Rust Speedup
Multi-File Composer | Composer & Agent Mode — Cursor Academy