Cursor 2.5: Async Subagents

New in Cursor! · Full changelog · Main announcement


Subagents just got a big upgrade. Previously, all subagents ran synchronously (the parent agent had to wait for each one to finish before moving on). Now subagents can run asynchronously, so the parent keeps working while subagents handle tasks in the background.

Subagents can also spawn their own subagents, creating a tree of coordinated work. This opens up bigger tasks like multi-file features, large refactors, and complex debugging where research and fixes can happen in parallel.

We’ve also improved subagent performance since 2.4, with lower latency, better streaming feedback, and more responsive parallel execution.

We’d love your feedback!

  • How are async subagents handling your larger, more complex tasks compared to before?
  • Have you noticed the performance improvements in subagent latency and streaming?
  • What kinds of tasks would benefit most from deeper subagent trees?

If you’ve found a bug, please post it in Bug Reports instead, so we can track and address it properly, but also feel free to drop a link to it in this thread for visibility.

4 Likes

I must have missed something, I’m using Cursor 2.5.17 and I still can’t get a subagent to run in the background, or have the coordinator/subagent pattern working. Do you have any tips to get this going?

2 Likes

I made this to help get started:

I find it much more repeatable to tag every agent in the starting prompt and say “Orchestrate among these subagents to complete the plan/task/etc.”

Recently, I’ve seen significant improvement in the rules helping with subagent orchestration. Because of that, I’ve put together this orchestration rule that gives all the context the agent needs to start orchestrating subagents.

You don’t have to use this, I just opened it up to make it helpful to others. But you can also copy this repository as a template by instructing your agent in Cursor:

Copy the subagent/rule setup in this repo https://github.com/tmcfarlane/oh-my-cursor but set it up like.... <insert any preference>

That’s what open-source means right? Copy/pasta? :winking_face_with_tongue:

See how it even uses a subagent to read the rule? Cursor has gone FULL SWARM :smiley:

is this update related to the is_background flag in subagent definition or is this a separate thing?

Hi! How do enable a subagent to run asynchronously and to spawn new subagents? Updated cursor but this does not work out of the box

It would be really handy if we could use subagents with composer 1.5, it’s my go to model and it can’t even spawn subagents, only models charged on API can, I’d rather pay API costs on composer 1.5 and have access to the features I’m paying for.

1 Like

I made this to help get started:

I find it much more repeatable to tag every agent in the starting prompt and say “Orchestrate among these subagents to complete the plan/task/etc.”

Recently, I’ve seen significant improvement in the rules helping with subagent orchestration. Because of that, I’ve put together [this orchestration rule](oh-my-cursor/rules/orchestrator.mdc at main · tmcfarlane/oh-my-cursor · GitHub) that gives all the context the agent needs to start orchestrating subagents.

Still, results vary. I still prefer to tag all the agents in the prompt and tell it to orchestrate.

is it supposed to just work if you tell the agent to parallelize, or do you need to structure the prompt a specific way? the docs don’t really explain the handoff between parent and child

I find it much more repeatable to tag every agent in the starting prompt and say “Orchestrate among these subagents to complete the plan/task/etc.”

1 Like

The subagents make Composer 1.5 blazingly fast when grepping, reading etc.

Its rare that I do more than 1 chat at once since its launch.

Do I know what they do under the hood, no, do I love the speed yes

This is:

Now subagents can run asynchronously, so the parent keeps working while subagents handle tasks in the background.

Additionally, subagents can now spawn other subagents.

1 Like

Yeah nothing I do can seem to trigger async mode unfortunately. It would be especially helpful if I asked a question if it didnt cancel all the subagents so the main agent could answer it

@charles I’m checking on this with the team. Adding notes in the description seems to do a good job of telling the subagent to run in the background, but is_background: true does not.

So far, I’m only able to run subagent on Sonnet and GPT 5.3 Codex, Composer 1.5 doesn’t want to run subagents for me.

I do have to explicitly request the agent to “use parallel subagents whenever safe and possible”

I ran it to build a feature I explicitly mentioned to create subagents and make it run parallel they are good. But I see the parent agent is not verifying the work it is missing the proper verification.

I created feature adding both my UI and API in same workspace and task to plan and add test cases also sub agent worked well but that is the only thing verification is what I didn’t satisfy

This will be fixed in 2.6, coming very soon.

1 Like

Closing this thread since it has been a while since this was announced. Any new questions, or loose ends from this thread should be filed as new reports in the appropriate forum category!