LiveKit docs › Components › Chat components › AgentChatTranscript

---

# Agent Chat Transcript

> A chat transcript for displaying conversational history.

## Usage

**[AgentChatTranscript](https://docs.livekit.io/reference/components/agents-ui/component/agent-chat-transcript.md)** preview:

```tsx
'use client';

import { 
  useSession, 
  useAgent,
  useSessionContext,
  useSessionMessages, 
} from '@livekit/components-react';
import { AgentSessionProvider } from '@/components/agents-ui/agent-session-provider';
import { AgentChatTranscript } from '@/components/agents-ui/agent-chat-transcript';

const TOKEN_SOURCE = TokenSource.endpoint('/api/token');

export function Demo() {
  const { state } = useAgent();
  const session = useSessionContext();
  const { messages } = useSessionMessages(session);

  return (
    <AgentChatTranscript
      agentState={state}
      messages={messages}
    />
  );
}

export default function DemoWrapper({ session }) {
  const session = useSession(TOKEN_SOURCE);

  return (
    <AgentSessionProvider session={session}>
      <Demo />
    </AgentSessionProvider>
  );
}
```

## Features

- Display the session's chat history in a styled list
- Renders the [`AgentChatIndicator`](https://docs.livekit.io/reference/components/agents-ui/component/agent-chat-indicator.md) when the `agentState` is "thinking"
- Supports both plain text and markdown formatting
- Automatically scrolls to the latest message
- Handles message updates and deletions

## Installation

```bash
pnpm dlx shadcn@latest add @agents-ui/agent-chat-transcript

```

## Props

| Prop name | Type | Default |
| --------- | ---- | ------- |
| `agentState?` | enum | – |
| `messages?` | ReceivedMessage[] | `[]` |
| `className?` | string | – |
| `ref?` | Ref<HTMLDivElement> | – |
| `...props?` | ComponentProps<'div'> | |

---

This document was rendered at 2026-06-07T11:33:37.188Z.
For the latest version of this document, see [https://docs.livekit.io/reference/components/agents-ui/component/agent-chat-transcript.md](https://docs.livekit.io/reference/components/agents-ui/component/agent-chat-transcript.md).

To explore all LiveKit documentation, see [llms.txt](https://docs.livekit.io/llms.txt).