Skip to main content
subagent CX Codex

dispatch_task — Claude Code subagent: tasks and setup

The dispatch_task Claude Code subagent takes work from another coding agent and handles it itself. It pauses for approval before actions that affect others or external systems.

MIT ★ 395 updated 2026-11-16

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

What dispatch_task does

dispatch_task works on a task handed over by another coding agent, rather than one typed by the user. It handles the work itself and does not pass it to another computer. Its final reply reports what it did, what it found, and where supporting evidence can be found, such as file paths or command output.

The subagent pauses for approval before pushing code, deploying or releasing, sending messages or comments, or changing someone else’s pull request. The exception is a task that consists only of one of those actions and explicitly permits it. For Claude Code, the agent file is .claude/agents/dispatch_task.md; Codex and Cursor have their own agent files.

What it helps with

  • handle work handed over by another coding agent
  • report completed work with supporting evidence
  • pause before changes with external effects

Example prompts for the agent

  • Assign dispatch_task to fix a data-handling bug and list the files it changes.
  • Ask dispatch_task to investigate a failure and include command output in its report.
  • Have dispatch_task prepare a code change and request approval before pushing it.

How to install dispatch_task

Manually: put the files in place

.claude/agents/dispatch_task.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 dispatch_task

How do I install dispatch_task in Claude Code?

Add .claude/agents/dispatch_task.md to the project.

What does dispatch_task do?

It handles tasks passed by another coding agent, then reports its work and supporting evidence. It requests approval before certain actions that affect others or external systems.

When does dispatch_task ask for approval?

Before pushing code, deploying or releasing, sending messages or comments, and changing someone else’s pull request. It can proceed without a separate approval only when the task itself consists solely of such an action and explicitly permits it.

Source text

dispatch_task.md · MIT
(Persona: this task was handed to you by another coding agent{{with .From}}, "{{.}}"{{end}}{{with .FromMachine}} on the computer {{.}}{{end}}, not typed by the user. That agent sees none of this conversation except your last reply, which it reads as the result: end with a complete final reply that says what you did, what you found, and where the evidence is (paths on this computer, branches, command output). Do the work here yourself; you cannot hand it on to another computer. Before pushing code, deploying or releasing, sending messages or comments to other people, or merging or changing someone else's PR, stop and ask the user, unless the task below is only that and says so.)

{{.Prompt}}

© nwverse · MIT · nwverse/persona

Similar subagents

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

From the same set61

The whole set →
supervision_instructions supervision_instructions is a Claude Code prompt for supervising agent tasks and checking their results. It defines how to track assignments, respond to status signals, and decide whether work is ready to accept. GP ChatGPT ★ 395repo stars task_continuation The task_continuation subagent for Claude Code resumes work on an existing to-do. It keeps the original brief, decisions, and history on that task instead of opening a separate follow-up. CX Codex ★ 395repo stars agent_unarchive The agent_unarchive Claude Code subagent returns an archived coding-agent session to the Agents list. It also asks the agent’s own tool to restore the session where it was archived. CX Codex ★ 395repo stars task_start_screen The task_start_screen Claude Code subagent reads the last lines of a task’s terminal tab when its agent failed to start. It shows a shell prompt waiting for input or the point where the agent’s screen stopped. CX Codex ★ 395repo stars task_retry The task_retry subagent for Claude Code restarts a task's agent after a failed launch. It reuses the existing tab when possible, or opens a new one. CX Codex ★ 395repo stars agent_read This Claude Code subagent reads a selected agent’s recent conversation. It answers follow-up questions about completed work, conclusions, or why the agent stopped. CX Codex ★ 395repo stars session_name The session_name Claude Code subagent names a session after the task being discussed. It uses the opening message and recent dialogue to reflect a change in direction. CX Codex ★ 395repo stars task_worker The task_worker Claude Code subagent handles an assigned part of a larger task. It can use in-session subagents but cannot pass work to other Persona tasks. CX Codex ★ 395repo stars

Project sponsors

Companies that keep this analytics open