If you've been coding with Cursor's AI agent and suddenly watched the little “Thinking...” indicator spin forever with nothing happening, you're not alone. Cursor Composer 2.5 freezing is one of the most reported issues on the Cursor community forum right now, and it tends to hit right when you're in the middle of a long agent session with multiple files open.

This guide walks through exactly why it happens, how to fix it right now, and what to do if it keeps coming back. No fluff, just steps that actually work, based on real reports from developers dealing with the same problem.

Quick-Fix Summary Box

If you're in a hurry, try these in order before reading the full guide:

Wait 30–60 seconds some “stuck” states resolve on their own under heavy load.