Skip to main content
subagent CX Codex

task_plan_withdraw — Claude Code subagent: what it does, install

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.

MIT ★ 395 updated 2026-11-16

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

What task_plan_withdraw does

The subagent removes a task_plan card from the waiting-to-start state and takes it out of the pending-plan and briefing lists. It records the reason and tells the user in one line which card was withdrawn and why.

It needs the plan's plan_id and a one-sentence reason in the user's language. It refuses plans that have started, were already withdrawn, or belong to another conversation; those plans remain unchanged.

What it helps with

  • withdraw a plan whose work was completed elsewhere
  • cancel a plan the user decided not to carry out
  • remove an unwanted card from pending-plan and briefing lists

Example prompts for the agent

  • Withdraw plan_123; the work was completed elsewhere.
  • Cancel plan_123 because the user decided not to do this plan.

How to install task_plan_withdraw

Manually: put the files in place

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

How do I install task_plan_withdraw in Claude Code?

Add the agent file at .claude/agents/task_plan_withdraw.md.

What does task_plan_withdraw do?

It withdraws a not-yet-started plan from the current conversation, records the reason, and reports which card it removed.

Which plans can task_plan_withdraw withdraw?

Only a plan from the current conversation that is still waiting to start. It leaves started plans, already withdrawn plans, and plans from other conversations unchanged.

Source text

task_plan_withdraw.md · MIT
Take down a plan card this conversation put up (task_plan) while nothing of it has started: its work was done elsewhere, or the user decided not to do it. The card stops waiting for the user's 开始, as when they dismiss it themselves, and leaves the to-handle lists (the snapshot's plans waiting to start, the briefings). Only for a plan of this conversation that still waits for 开始; a started or dismissed plan, or another conversation's, is refused and nothing changes. Your reason is kept on record; tell the user in a line which card you took down and why.

```json
{
  "type": "object",
  "required": ["plan_id", "reason"],
  "properties": {
    "plan_id": {
      "type": "string",
      "description": "the plan's id (plan_…), as task_plan's answer or the snapshot's plans waiting to start give it"
    },
    "reason": {
      "type": "string",
      "description": "why it is no longer needed, in the user's language, one sentence"
    }
  }
}
```

© nwverse · MIT · nwverse/persona

Similar subagents

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

From the same set61

The whole set →
codex_continuation The codex_continuation Claude Code subagent picks up a task from a separate Codex conversation in a fresh session. It uses recent messages to recover decisions, constraints, and unfinished work. CX Codex ★ 395repo stars question_released The question_released Claude Code subagent ends the current turn when another message arrives while a question awaits the user’s answer. The question card stays unchanged, and the answer returns in a later message. CX Codex ★ 395repo stars direction_name The direction_name Claude Code subagent assigns a name to a direction linked to a leader conversation. The app and work-log extension display that label. CX Codex ★ 395repo stars 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 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_spawn 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. 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

Project sponsors

Companies that keep this analytics open