task_update
Update a task's fields, progress note, or status. It automatically claims and renews the task, so no separate task_claim is needed; refuses if another operator holds it.
Instructions
Change a task: fields, a progress note, or status (done / deleted with reason / pending to reopen). Claims it for you first and renews your claim (never shortens it), so no task_claim is needed before or after an update; refuses if another operator holds it. Set waiting_on:"" to clear.
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": {
"id": "<id>"
},
"name": "task_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Task id: the 8-character id shown in task_context/task_list (full UUID also works). | |
| cwd | No | Session folder (absolute path). Filled in by the OpenCode plugin; other clients pass the working folder. | |
| due | No | ||
| gate | No | Operator methodology gate 0-8. | |
| kind | No | ||
| note | No | Decision, evidence or verification. Not a command narration. | |
| risk | No | Operator methodology risk class. | |
| tags | No | snake_case tags, one per item. | |
| wait | No | Keep out of NEXT until this date. | |
| status | No | done only after the outcome is verified; owner-dependent work stays open with waiting_on. | |
| depends | No | Ids of tasks that must finish first. On update this replaces the list ([] clears it). | |
| project | No | ||
| priority | No | ||
| repo_path | No | Canonical folder being changed. Defaults to the session folder (not operator lanes). | |
| scheduled | No | ||
| waiting_on | No | Owner-dependent: who must act (e.g. "owner approval"). Kept out of NEXT until cleared with "". | |
| description | No | ||
| remove_tags | No | ||
| context_summary | No | Handoff-quality context: what, why, where it stands. |