What is maximum sub agent creation limit?

Support Help
1

i try to create more than 40 sub agents with two rule files! but it shows couldn’t start may i know what maximum limits is? or any best practices? because it shows error as well in another main agent like “workspace disconnected”

  • also want to understand how to force stop all sub agent! from one place?
6

Hi @He_Ro Thanks for the post! The answer is it depends. There’s no fixed limit. Spinning up multiple dozens may run into issues. Under the hood the parallelism is simply however many subagent tasks get launched in a turn, so there isn’t a hard number that Cursor caps you at.

What you ran into is a resource limit, not a subagent-count limit. Launching ~40 subagents at once overwhelms the extension host that runs them, so some can’t get started (“Couldn’t start”), and the main agent loses its connection to the workspace, which is what “Workspace Disconnected” means. It’s an extension-host / workspace-connection timeout, not a “too many subagents” error. Reloading the window recovers the main agent: open the Command Palette (Cmd/Ctrl+Shift+P) and run “Reload Window.”

Your two rule files aren’t the cause.

A few best practices that keep this stable:

  • Keep parallelism modest. A handful of concurrent subagents is far more reliable than dozens.
  • Batch the work into waves and let one wave finish before starting the next, rather than fanning out ~40 at once.
  • Use subagents for focused delegation instead of mass parallel execution.