# Agent Todo

> Collapsible agent task plan with live status marks.

Registry name: `agent-todo`. HTML docs: https://ui.anuragroy.dev/component/agent-todo.

## Install

```bash
npx shadcn@latest add https://ui.anuragroy.dev/r/agent-todo.json
```

If the website is down: `npx shadcn@latest add https://raw.githubusercontent.com/anurag-roy/ui.anuragroy.dev/main/public/r/agent-todo.json`.

Registry JSON: https://ui.anuragroy.dev/r/agent-todo.json (GitHub: https://raw.githubusercontent.com/anurag-roy/ui.anuragroy.dev/main/public/r/agent-todo.json).

## Import

Import paths follow the consumer `components.json` aliases. After a default install:

```tsx
import {
  AgentTodo,
  AgentTodoHeader,
  AgentTodoItem,
  AgentTodoList,
  AgentTodoProgress,
  AgentTodoTitle
} from "@/components/ui/agent-todo"
```

## Usage

```tsx
import {
  AgentTodo,
  AgentTodoHeader,
  AgentTodoItem,
  AgentTodoList,
  AgentTodoProgress,
  AgentTodoTitle,
} from "@/components/ui/agent-todo"

export function Example() {
  return (
    <AgentTodo>
      <AgentTodoHeader>
        <AgentTodoTitle>Dashboard iteration</AgentTodoTitle>
        <AgentTodoProgress completed={1} total={4} />
      </AgentTodoHeader>
      <AgentTodoList>
        <AgentTodoItem status="completed">Audit the current shell</AgentTodoItem>
        <AgentTodoItem status="running">Group KPI cards</AgentTodoItem>
        <AgentTodoItem status="pending">Add a timeframe selector</AgentTodoItem>
      </AgentTodoList>
    </AgentTodo>
  )
}
```

## API

### AgentTodoItem

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `status` | "pending" \| "running" \| "completed" \| "failed" | "pending" |  |

### AgentTodoProgress

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `completed` | number | — |  |
| `total` | number | — |  |

## See also

- [HTML page](https://ui.anuragroy.dev/component/agent-todo): Preview and the same docs in the site chrome.
- [Registry item](https://ui.anuragroy.dev/r/agent-todo.json): Source files and dependencies.
- [Catalog](https://ui.anuragroy.dev/component): All components.
- [llms.txt](https://ui.anuragroy.dev/llms.txt): Agent index for this library.