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
| Tool | Does |
|---|---|
TodoWrite | Replaces the visible to-do list with the agent’s current plan. |
TaskCreate, TaskGet, TaskList, TaskUpdate | Create tasks and read or change their state. |
TaskOutput, TaskStop | Read 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.