shipitagent

Tools · Agents and tools

task_stop

Changes things

Stop a background task (a command or a sub-agent) by its task id.

When to use: Stop background work you no longer need: a dev server you are done with, or a delegation that went the wrong way. Ids come from the tool that started it.

Example

The call

tool call
{
  "tool": "task_stop",
  "arguments": {
    "task_id": "subagent-7f3a"
  }
}

Needs a running background sub-agent (sub_agent with background=true)

So it isn't run here, and no output is shown: nothing on this page is made up.

Parameters

NameTypeDescription
task_id*stringThe background task's id

* required

Hand work to sub-agents and find the right tool when there are many.