---
title: "Thinking States | Free React & Tailwind Agents Component | Motion UI"
canonical: "https://blacknest.dev/motion/c/agents/thinking-states"
github_source: "https://github.com/Rkj0123/motion-ui-skill/blob/main/components/agents/thinking-states.tsx"
install_command: "npx motion-ui-skill add thinking-states"
dependencies: ["clsx","motion","react","tailwind-merge"]
category: "agents"
subcategory: "agents"
---

# Thinking States

> Conversational AI agent thinking bubble morphing through cognitive stages (evaluating, searching, reasoning, finalizing) with organic pulse dots.

Synthesized from conversational agent UX patterns in [transitions.dev](https://github.com/Jakubantalik/transitions.dev). Replaces static spinners with dynamic status morphs that give users clear transparency into LLM planning and tool execution.

## Install

```bash
npx motion-ui-skill add thinking-states
```

## Dependencies

- `clsx`
- `motion`
- `react`
- `tailwind-merge`

## Usage

```tsx
"use client";

import { ThinkingStates } from "@/components/agents/thinking-states";

export function ThinkingStatesDemo() {
  return (
    <div className="flex items-center justify-center p-8">
      <ThinkingStates autoCycle={true} />
    </div>
  );
}
```

## API Reference

### ThinkingStates

| Prop | Type | Default | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| `stage` | `"evaluating" \| "searching" \| "reasoning" \| "synthesizing" \| "finalizing"` | Controlled / internal cycle | No | Explicit stage override |
| `autoCycle` | `boolean` | `true` | No | Automatically cycle through stages for demonstration |
| `className` | `string` | — | No | Additional CSS classes |

## Source Files

- [components/agents/thinking-states.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/agents/thinking-states.tsx)
- [lib/ease.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/ease.ts)
- [lib/utils.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/utils.ts)
