Skip to main content

Definition

Assembly: CloudNimble.ClaudeEssentials.dll Namespace: CloudNimble.ClaudeEssentials.Hooks.Tools.Responses Inheritance: System.Object

Syntax

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 the tool_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
Example JSON payload:

Constructors

.ctor

Syntax

.ctor Inherited

Inherited from object

Syntax

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 completed
  • ActiveForm - 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 object

Syntax

Parameters

Returns

Type: bool

Equals Inherited

Inherited from object

Syntax

Parameters

Returns

Type: bool

GetHashCode Inherited Virtual

Inherited from object

Syntax

Returns

Type: int

GetType Inherited

Inherited from object

Syntax

Returns

Type: System.Type

MemberwiseClone Inherited

Inherited from object

Syntax

Returns

Type: object

ReferenceEquals Inherited

Inherited from object

Syntax

Parameters

Returns

Type: bool

ToString Inherited Virtual

Inherited from object

Syntax

Returns

Type: string?