assistant-ui
Overview and router for assistant-ui, the React library for building AI chat interfaces from composable primitives. Use for high-level, cross-cutting, or architecture-overview questions: choosing packages, picking a runtime, or understanding the layered model (RuntimeCore, Runtime, context hooks, primitives) and message model. Covers the `@assistant-ui/react` core plus `@assistant-ui/react-ai-sdk`, `@assistant-ui/react-langgraph`, `assistant-stream`, and `assistant-cloud`; `AssistantRuntimeProvi
Security Assessment
About assistant-ui
The `assistant-ui` skill provides a React library designed for building AI chat interfaces using composable primitives. It addresses the challenge of creating flexible and extensible chat UIs that can integrate with a variety of AI backends while maintaining full control over user experience. By offering a structured approach to UI components, runtime management, and backend adapters, this skill simplifies the development of interactive AI applications and ensures consistent behavior across different environments.
The main features of `assistant-ui` include a set of UI primitives such as ThreadPrimitive, MessagePrimitive, and ComposerPrimitive, context hooks like useAui, useAuiState, and useAuiEvent for managing state and events, and a runtime layer that handles thread and message execution. The skill also provides multiple adapters for connecting to AI SDKs, LangGraph, custom APIs, and cloud persistence, along with prebuilt packages for streaming, Markdown rendering, and backend integration. Developers can choose from different runtime configurations depending on their backend setup, allowing for seamless integration with AI SDKs, external state management, or custom APIs.
`assistant-ui` is best suited for developers and teams building AI chat applications from scratch or integrating chat functionality into existing platforms. It is particularly useful for projects that require custom message types, multi-thread management, and production-ready features like cloud persistence and analytics. Typical use cases include creating highly interactive AI chatbots, developing multi-thread conversational apps, or customizing chat UI components for enterprise-grade AI applications.
FAQ
How do I integrate `assistant-ui` with an existing AI backend?
You can connect `assistant-ui` to any AI backend using the provided runtime adapters such as useChatRuntime for AI SDKs, useLangGraphRuntime for LangGraph agents, or useLocalRuntime for custom APIs.
Which React hooks are available for state management?
The skill provides useAui, useAuiState, and useAuiEvent hooks to interact with threads, messages, and runtime events within your application.
Can `assistant-ui` handle multi-threaded chat applications?
Yes, it includes built-in thread list management and runtime support to manage multiple threads concurrently.
Are there any backend dependencies required to use this skill?
No specific backend is required. You can use the AI SDK, LangGraph, AG-UI/A2A protocols, or any custom API with the appropriate runtime adapter.
What limitations should I be aware of?
While `assistant-ui` provides flexible UI primitives and runtime management, advanced features like custom adapters or cloud persistence require appropriate backend setup and configuration.
Install assistant-ui
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
assistant-ui/skills