Background task

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

The cursor’s background task can sometimes block the agent’s dialogue.

Steps to Reproduce

Using the skill to run a subAgent with ‘run_in_background: true’, this subAgent occasionally blocks the main window’s dialog.

Operating System

MacOS

Version Information

Version: 3.1.10 (Universal)
VSCode Version: 1.105.1
Commit: dacbe9b31599a253763e4910eb6ab38704653320
Date: 2026-04-13T11:39:16.806Z
Layout: editor
Build Type: Stable
Release Track: Default
Electron: 39.8.1
Chromium: 142.0.7444.265
Node.js: 22.22.1
V8: 14.2.231.22-electron.0
OS: Darwin arm64 23.6.0

Does this stop you from using Cursor

No - Cursor works, but with this issue

Hi @hongweihu

Thanks for reporting this. This is a known intermittent behavior with run_in_background on custom subagents.

The core fix for is_background: true in frontmatter shipped in an earlier release and is included in your version (3.1.10).

A couple of things that may help increase reliability:

  1. Add explicit instructions in your skill’s prompt telling the agent to always run the subagent in the background. Reinforcing the intent in the prompt (not just the frontmatter) gives the model stronger signal.

  2. Keep the is_background: true (or background: true) in your frontmatter as well, since it serves as the default when the model doesn’t specify.

The team is actively working on improving async subagent behavior, so this should get more reliable over time.

image

Okay, thank you for your reply! I’m not sure if my explanation is correct. My background task always shows as started, as shown in the image above. Sometimes my main window dialog still shows as running (I understand that this might need to be fixed, as the background task’s status affects the main thread’s status), but other times it works, and I can continue the dialog while the background task continues running in the background.