SDKTodo tracking

Todo tracking for programs

While it works, the agent keeps a checklist of the job: the steps it plans, which are underway, and which are done. This page covers the tools that maintain that list, how subagents share them, and how a program can keep them or switch them off.

The tools

ToolDoes
TodoWriteReplaces the visible to-do list with the agent’s current plan.
TaskCreate, TaskGet, TaskList, TaskUpdateCreate tasks and read or change their state.
TaskOutput, TaskStopRead the result of a background task, or stop it.

The agent decides when to use them, based on the job in front of it.

Subagents

A subagent that runs in the foreground keeps the task-tracking tools when the session has them enabled. Subagents report their work back to the parent session, which is where a program reads the outcome.

Keep or remove the tools for a run

Block the list tools with --disallowed-tools:

syntic -p "rename the config keys in src/config.rs" --disallowed-tools "TodoWrite"

Blocking the tools removes the checklist from the run. The agent still plans, but it does not keep a list.

Interactive use

In the interactive CLI, /todos shows the agent’s current todo list. For keyboard shortcuts, see Keyboard shortcuts and Slash commands.

The checklist is a working aid for the agent, not a project record. If a program needs a durable list of work, keep it in a file or an issue tracker the program owns.