# Tool Approval

> Allow once, remember, or deny a paused tool call.

Registry name: `tool-approval`. HTML docs: https://ui.anuragroy.dev/component/tool-approval.

## Install

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

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

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

## Import

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

```tsx
import {
  ToolApproval,
  ToolApprovalButtons,
  ToolApprovalDescription,
  ToolApprovalDetails,
  ToolApprovalHeader,
  ToolApprovalTitle
} from "@/components/ui/tool-approval"
```

## Usage

```tsx
import {
  ToolApproval,
  ToolApprovalButtons,
  ToolApprovalDescription,
  ToolApprovalDetails,
  ToolApprovalHeader,
  ToolApprovalTitle,
} from "@/components/ui/tool-approval"

export function Example() {
  return (
    <ToolApproval>
      <ToolApprovalHeader>
        <ToolApprovalTitle>Archive 3 draft conversations?</ToolApprovalTitle>
        <ToolApprovalDescription>
          This tool can permanently hide drafts.
        </ToolApprovalDescription>
      </ToolApprovalHeader>
      <ToolApprovalDetails>archiveDrafts({ count: 3 })</ToolApprovalDetails>
      <ToolApprovalButtons
        onAllow={() => undefined}
        onAlways={() => undefined}
        onDeny={() => undefined}
      />
    </ToolApproval>
  )
}
```

## API

### ToolApprovalButtons

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `onAllow` | () => void | — |  |
| `onAlways` | () => void | — |  |
| `onDeny` | () => void | — |  |

## See also

- [HTML page](https://ui.anuragroy.dev/component/tool-approval): Preview and the same docs in the site chrome.
- [Registry item](https://ui.anuragroy.dev/r/tool-approval.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.