The subAgent is not working

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

I configured a subAgent, but no matter what I do, it just won’t trigger.

Steps to Reproduce

Configure a subAgent and attempt to trigger it.

Operating System

MacOS

Current Cursor Version (Menu → About Cursor → Copy)

Version: 2.4.0-pre.29.patch.0 (Universal)
VSCode Version: 1.105.1
Commit: 31ba4eea39481b2e13065083d98cf92613175e00
Date: 2026-01-13T20:27:33.722Z
Build Type: Stable
Release Track: Nightly
Electron: 37.7.0
Chromium: 138.0.7204.251
Node.js: 22.20.0
V8: 13.8.258.32-electron.0
OS: Darwin arm64 24.5.0

Does this stop you from using Cursor

No - Cursor works, but with this issue

Hey, thanks for the report. Subagents are a very new feature in Nightly, and we’re actively working on them right now.

To figure this out, we’ll need a bit more detail:

  1. How exactly did you set up the subAgent? (can you share a screenshot of the config)
  2. How are you trying to trigger it? (what steps or commands are you doing in the agent)
  3. What do you expect to see vs what are you seeing right now?
  4. Do you see any errors in the Developer Console? (Help > Toggle Developer Tools)

That’ll help us tell if this is a known bug or something new.

1 Like

How to use them anyway?

What am I doing wrong?

1 Like

Hello! Jumping in to the conversation here.

As far as I can tell, Cursor bolted on “subagents” mainly to make existing Claude Code configs look compatible: by default it tries to load ~/.claude/agents/.md and then surfaces that as a subagent in the UI.

In Claude Code, agents are actually used as real sub‑roles/tools that the main agent can delegate to, with proper routing and prompt plumbing. In Cursor right now it’s basically: read the file, show it in the UI, error out and then not really invoke it in a way that behaves like Claude Code at all.

If the goal is Claude‑config compatibility, this should:

  • Treat those agents as first‑class tools the main agent can call
  • Pass through the same rules/agent prompts Claude uses
  • Be clearly documented so users know what’s implemented vs “future idea”

Right now it just makes people think they misconfigured something, when in reality the implementation isn’t actually matching the Claude behavior they’re mimicking.

From what I understand, there is a problem with the initial loading of the file, it’s prompt is completely ignored.

Screenshots

Claude Code Opus 4.5 Fetch Story using MCP

Cursor 2.4.7 Same Model Same Prompt(no subagent is called)

The attempt cursor does when the subagent is mentioned with a slash command

The Error, with no explanation on Cursor

when they work they are actually like the claude code ones

with the exception that you cant continue working in the same chat window or delegate them to the background and have to wait for completion, guess its better to write a skill which starts a cursor-cli agent instead for the task at hand if you dont want to wait