# AI Conversation History

Chat assistant with a side history where the user searches, renames and pins important conversations.

- id: `ai-conversation-history`
- Page: https://agentic-ui-kit.com/components/ai-conversation-history
- Live preview: https://agentic-ui-kit.com/live/component/ai-conversation-history

## Install

```bash
agentic-ui add ai-conversation-history
npx shadcn@4.17.0 add @agentic-ui/ai-conversation-history
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york)
- **Capabilities:** conversation-list, conversation-search, inline-rename, pin-conversation, archive-conversation, share-conversation, share-scope-control, date-grouping, match-highlighting, delete-conversation, empty-state, no-results-state, error-recovery, keyboard-navigation
- **Intents:** converse, manage-collection, navigate, explore-detail, create-edit
- **Suits domains:** ai-workspace, ai-agents, saas, support, knowledge
- **Interaction:** conversation-search, inline-rename, pin-toggle, archive-toggle, share-dialog, context-menu, keyboard-navigation
- **Screen role:** management
- **Density:** compact
- **Dark mode:** yes
- **Use it for:** chat assistant with a side history where the user searches, renames and pins important conversations, agent console that archives closed runs and shares a read-only link with the team, support workspace that finds an earlier conversation by the text of its last message, product copilot that groups sessions by date and keeps pinned ones at the top
- **Avoid when:** listing messages inside an open conversation (use ai-message-list), document version history with diff (use docs-version-history), main application navigation with no conversational entities (use a standard navigation sidebar)
- **Preserve when adapting:** pinned-and-date-grouping, per-conversation-action-model, search-and-highlight-behaviour, share-scope-model
- **Replace when adapting:** domain-copy, conversation-source-adapter, share-link-format
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** badge, button, dialog, dropdown-menu, skeleton
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives