claim_task
Claims a ready task for an external agent—or releases its claim—and returns the task card plus worktree. Omit task_id to claim the first ready task; claims expire after 15 minutes idle.
Instructions
External agents only: claim a ready task (all dependencies accepted, nobody holding it) or, with release: true, give yours back (its leases are released; the work stays in the worktree). Without task_id, the first ready task (your team's first) is claimed. Returns the task card and the worktree to work in. External workers' claims expire after 15 minutes without a tool call.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"execution_id": "<execution_id>",
"agent_token": "<agent_token>"
},
"name": "claim_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Why you release it (recorded). | |
| release | No | Release your claim instead. | |
| task_id | No | ||
| agent_token | Yes | The agent token join_execution returned (once). | |
| execution_id | Yes | The heads-down run (exe-…). |