elements
Installation
SKILL.md
assistant-ui Elements
Always consult assistant-ui.com/llms.txt for the latest API.
Elements are the styled, copy-into-your-project components that sit on top of the unstyled primitives. Every element is a TSX file the CLI copies into components/assistant-ui/elements/, so you own the source and customize it in place. The catalog at assistant-ui.com/elements documents each one with a live demo, a runtime recipe, and a standalone recipe.
References
- ./references/catalog.md -- every element by section with its registry item and installed file
- ./references/aui-elements.md -- the runtime-connected elements (Thread, ThreadList, AssistantModal, AssistantSidebar, ToolFallback, ToolGroup, Reasoning, Sources, Attachment, ModelSelector, Voice, McpConfig, and the renderers)
- ./references/standalone-elements.md -- props-driven elements grouped by section, with the prop shapes that matter
Two kinds of element
| Kind | File | Needs a runtime | Registry item |
|---|---|---|---|
| Runtime-connected | elements/<name>.aui.tsx |
Yes, reads the nearest AssistantRuntimeProvider |
short name: thread, thread-list, tool-fallback, reasoning, ... |
| Standalone | elements/<name>.tsx |
No, everything comes in through props | elements-<slug>: elements-agent-plan, elements-code-diff, ... |
| Renderer | elements/<name>.tsx |
Used from a .aui element or a toolkit render |
markdown-text, syntax-highlighter, shiki-highlighter, mermaid-diagram, generative-ui |