todo
Lists, adds, completes or clears items for this chat.
Lists, adds, completes or clears items for this chat.
- Tool name
- todo
- Group
- Session helpers
- Risk
- low
- Needs approval
- never
- Approval rule
- No approval.
- Allowed in scheduled jobs
- No
- Default
- on
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| action | string | Yes | What to do. | One of: list, add, done, clear. | |
| text | string | No | Text to type or say. | ||
| id | string | No | Item id. |
Returns
The list.
Example (made up for this page)
{
"action": "list"
}1. [ ] write summarySide effects
- Writes a per-chat JSON file.
How it can fail
| When | What the agent sees |
|---|---|
| Unknown id | Todo id not found |
See also:Session helpers tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.