Skip to main content
subagent CX Codex

task_spawn — Claude Code subagent: setup and task splitting

The task_spawn Claude Code subagent starts a separate agent for part of an active assignment. The new agent joins the same to-do list and reports to the same supervisor.

MIT ★ 395 updated 2026-11-16

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/task_spawn.md
Open on GitHub

What task_spawn does

task_spawn starts a separate coding agent to handle part of the work already assigned to its parent. The child stays in the existing to-do and under the same supervisor; it does not become a team lead or open a new task.

Give it a short title and a self-contained prompt describing the work and what evidence to return. Unrelated work must go to the supervisor. The agent can replace a runtime’s standalone new-conversation action, such as Codex create_thread. The server derives the task, parent, launcher, and permissions from the verified assignment. When permission is unknown, access remains read-only. Do not retry a launch if its outcome is uncertain.

What it helps with

  • split part of an active assignment into separate agent work
  • give an agent a self-contained task with evidence to return
  • run parallel work under the same supervisor and to-do

Example prompts for the agent

  • Handle the error-reporting part of the current assignment and return the changes with supporting evidence.
  • Inspect the current module for validation issues, stay within this assignment, and list the affected areas.

How to install task_spawn

Manually: put the files in place

.claude/agents/task_spawn.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about task_spawn

How do I install task_spawn in Claude Code?

Place task_spawn.md at .claude/agents/task_spawn.md.

What does task_spawn do?

It starts a separate agent for part of the current assignment. That agent joins the existing to-do and keeps the same supervisor.

What permissions does the child agent get?

The server derives permissions from the verified assignment. If permission is unknown, the child remains read-only.

Source text

task_spawn.md · MIT
Start a separate coding Agent for part of your current supervised task, on your current computer and directory. It joins the SAME to-do with the SAME supervisor; this does not make you a task leader or create a new task. Use this instead of a runtime's standalone new-conversation tool (for example Codex create_thread). Title and prompt must describe work within the existing assignment; ask your supervisor for an unrelated task. The server chooses the task, parent, launcher and permission from your verified assignment, never from arguments. Unknown permission stays read-only. The result names the child session, to-do and supervisor. Do not retry a start with an uncertain result.

```json
{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Short title for this part of the existing task"
    },
    "prompt": {
      "type": "string",
      "description": "Self-contained assignment within the current task; include what evidence to return"
    }
  },
  "required": ["title", "prompt"],
  "additionalProperties": false
}
```

© nwverse · MIT · nwverse/persona

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set61

The whole set →
question_moved_to_todo The question_moved_to_todo Claude Code subagent moves an unanswered question into the user's to-do list. It waits for a decision while the agent continues with work that does not depend on it. CX Codex ★ 395repo stars task_plan_withdraw The task_plan_withdraw Claude Code subagent withdraws a plan that has not been started. It runs when a plan from the current conversation is no longer needed. CX Codex ★ 395repo stars question_asked_later The question_asked_later Claude Code subagent sends a question to the user as a card on their phone. It finishes unrelated work and ends the turn without guessing while the answer is pending. CX Codex ★ 395repo stars launcher_repair launcher_repair — a subagent for Claude Code and Codex repairs agent CLI launchers on a specified machine. It tests each launcher after making changes. CX Codex ★ 395repo stars task_leader The task_leader subagent for Claude Code splits work among child agents and checks their results against defined completion criteria. It handles review decisions for each delegated task. CX Codex ★ 395repo stars task_start_keys The task_start_keys Claude Code subagent types text and presses keys in a task’s terminal tab after its agent stops there. It can answer a shell prompt or move past the screen’s current point. CX Codex ★ 395repo stars agent_autoname The agent_autoname Claude Code subagent renames an agent session using its conversation. It runs only after an explicit Auto Rename request. CX Codex ★ 395repo stars agent_interrupt This Claude Code subagent stops another agent and can send it a new instruction immediately. Use it to interrupt a stalled loop, repeated failure, or work heading in the wrong direction. CX Codex ★ 395repo stars

Project sponsors

Companies that keep this analytics open