Definition
Assembly: CloudNimble.ClaudeEssentials.dll Namespace: CloudNimble.ClaudeEssentials.Hooks.Tools.Responses Inheritance: System.ObjectSyntax
Summary
Represents the response payload returned by the Claude Code TodoWrite tool after updating the task list.Remarks
The TodoWrite tool creates and manages a structured task list for the current coding session. It helps Claude track progress, organize complex tasks, and demonstrate thoroughness to the user. This response is received in the TodoWritePostToolUsePayload when thetool_name is “TodoWrite”.
The response includes both the previous state (TodoWriteToolResponse.OldTodos) and the new
state (TodoWriteToolResponse.NewTodos) of the todo list, enabling hooks to track what changed.
Use cases for the TodoWrite tool include:
- Complex multi-step tasks requiring 3 or more distinct steps
- Tasks that require careful planning
- When the user provides multiple tasks to complete
- Tracking progress through large implementations
Constructors
.ctor
Syntax
.ctor Inherited
Inherited from
objectSyntax
Properties
NewTodos
Gets or sets the new state of the todo list after this update.Syntax
Property Value
Type:System.Collections.Generic.List<CloudNimble.ClaudeEssentials.Hooks.Tools.Inputs.TodoItem>
Remarks
This contains the complete todo list after the TodoWrite operation. It reflects all additions, removals, and status changes that were made. Each TodoItem includes:Content- The task description (imperative form)Status- Current state: pending, in_progress, or completedActiveForm- Present continuous form for display during execution
OldTodos
Gets or sets the previous state of the todo list before this update.Syntax
Property Value
Type:System.Collections.Generic.List<CloudNimble.ClaudeEssentials.Hooks.Tools.Inputs.TodoItem>
Remarks
This contains the complete todo list as it existed before the TodoWrite operation was performed. Comparing this with TodoWriteToolResponse.NewTodos allows hooks to determine exactly what changed. This will be an empty list if no todos existed before this operation (i.e., this is the first TodoWrite in the session).Methods
Equals Inherited Virtual
Inherited from
objectSyntax
Parameters
Returns
Type:bool
Equals Inherited
Inherited from
objectSyntax
Parameters
Returns
Type:bool
GetHashCode Inherited Virtual
Inherited from
objectSyntax
Returns
Type:int
GetType Inherited
Inherited from
objectSyntax
Returns
Type:System.Type
MemberwiseClone Inherited
Inherited from
objectSyntax
Returns
Type:object
ReferenceEquals Inherited
Inherited from
objectSyntax
Parameters
Returns
Type:bool
ToString Inherited Virtual
Inherited from
objectSyntax
Returns
Type:string?