todo_write
Records the task list for the work in progress, so the user can see what is done and what is left.
Send the complete list every time — it replaces the previous one rather than adding to it. Keep exactly one item in_progress, and mark an item completed as soon as it is finished rather than in a batch at the end.
Use it for work with several distinct steps, and for a plan the user has just approved. Skip it for a single-step change or a question: a one-item list tells the user nothing they did not already know.
This records intent only. It changes no files and runs nothing, so it is available while planning.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
todos |
array |
Yes | The complete task list, in the order the steps will be done. Replaces the previous list. |
Example#
todo_write({ todos: "…" })Approval#
Runs without asking. Records what the agent intends; changes nothing.
See also#
- Tools — every tool, and which of them can change your files
- Approval modes — what gates the tools that change things
Added in woopcode@0.6.0