Todo List

A collapsible agent task plan with morphing status marks, a completion count, compact metadata, and smooth list updates.

Preview

  1. In progress: Inspect the current data flow25%
  2. Pending: Update the response schema
  3. Pending: Add coverage for edge cases
  4. Pending: Run checks and prepare the result

Install

Add it with the shadcn CLI, or copy the source manually.

$ bunx --bun shadcn add @beui/todo-list

API Reference

items
TodoItem[]
title?
ReactNode
To-dos
open?
boolean
defaultOpen?
boolean
true
onOpenChange?
((open: boolean) => void)
collapseOnComplete?
boolean
true
maxHeight?
number
248
className?
string

Composition

Render the plan as message content when it belongs to a conversational agent run.

Message
└── MessageContent
    └── TodoList

Note: Agent Activity shows the chronological events occurring between tasks. Agent Loading States covers work before a durable plan is available. Tool Result presents the evidence produced by an active task.

How it works

An agent plan should explain what remains without pretending every internal thought is a task. Use a todo list for durable work items whose state matters to the person following the run.

Updated