Answer: A subagent is a child role inside one agent that inherits the parent project and is reachable only by the parent, while a peer is an independent agent and session that owns its own project surface and is reachable by local co-hosted agents or declared deployments on the same team. Status: Confirmed Entry: tool/cursor/agents-and-automation/peer-vs-subagent Revision: 1 Digest: sha256:e8aa963d2eae5953 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:08:28Z Last changed: 2026-11-13T03:08:28Z Last verified: 2026-11-20T12:32:44Z Next check: 2026-11-21T12:32:44Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of Subagent context | Child role inside one agent | [1] | 2026-11-20 Peer context | Independent agent and session | [1] | 2026-11-20 Subagent tools and connections | Inherits the parent project | [1] | 2026-11-20 Peer tools and connections | Owns its project surface | [1] | 2026-11-20 Subagent reachability | Parent only | [1] | 2026-11-20 Peer reachability | Local co-hosted agents, or declared deployments on the same team | [1] | 2026-11-20 Sources: [1] Anysphere. "cursor.com/docs/agent-sdk/guides/agent-to-agent.md". https://cursor.com/docs/agent-sdk/guides/agent-to-agent.md Role: primary. Accessed: 2026-11-20T12:32:44Z Quote: "Child role inside one agent" (Supports: Subagent context) Quote: "Independent agent and session" (Supports: Peer context) Quote: "Inherits the parent project" (Supports: Subagent tools and connections) Quote: "Owns its project surface" (Supports: Peer tools and connections) Quote: "Parent only" (Supports: Subagent reachability) Quote: "Local co-hosted agents, or declared deployments on the same team" (Supports: Peer reachability) Snapshot SHA-256: b467f20da71721741a8a1aaa93e2edc57a4fc3c0ca29a6c43b97074bc6348b58 (captured 2026-11-13T03:08:27Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-13T03:08:28Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:32:44Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:32:44Z Last attempt: 2026-11-20T12:32:44Z Notes and limitations: Extracted automatically from a single official source (section "Peer or subagent?"). Related: https://latestn.com/tool/cursor/agents-and-automation/playground-multiple-agents-url How do I access the Cursor Agent SDK playground when hosting multiple agents? https://latestn.com/tool/cursor/agents-and-automation/read-agent-metadata How do I read agent metadata from inside a Cursor Cloud Agent VM? https://latestn.com/tool/cursor/agents-and-automation/remote-control-handoff How do I hand off a local Cursor session to my phone using Remote Control? https://latestn.com/tool/cursor/agents-and-automation/my-machines-vs-team-pools When should I use My Machines versus Team Pools for self-hosted Cursor Cloud Agents? https://latestn.com/tool/cursor/agents-and-automation/notion-mention-assign-task How do I mention the Cursor agent or assign a task to it in Notion? https://latestn.com/tool/cursor/agents-and-automation/one-conversation-per-ticket How do I keep one Cursor agent conversation per ticket or thread in a webhook channel? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-13T03:08:28Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/cursor/agents-and-automation/peer-vs-subagent/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/cursor/agents-and-automation/peer-vs-subagent POST: https://latestn.com/dispute/tool/cursor/agents-and-automation/peer-vs-subagent with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/cursor/agents-and-automation/peer-vs-subagent?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). What is the difference between a peer agent and a subagent in Cursor? Revision 1, last verified 2026-11-20T12:32:44Z. https://latestn.com/tool/cursor/agents-and-automation/peer-vs-subagent (accessed 2026-11-21T10:02:14Z). @misc{LatestN_tool_cursor_agents_and_automation_peer_vs_subagent_r1, title = {What is the difference between a peer agent and a subagent in Cursor?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/cursor/agents-and-automation/peer-vs-subagent}}, note = {Revision 1; digest sha256:e8aa963d2eae5953; last verified 2026-11-20T12:32:44Z; accessed 2026-11-21T10:02:14Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/cursor/agents-and-automation/peer-vs-subagent