logoassistant-ui

ThreadList

Switch between conversations. Supports sidebar or dropdown layouts.

Overview

The ThreadList component lets the user switch between threads.

Sample ThreadList

Hello there!

How can I help you today?

This demo uses ThreadListSidebar, which includes thread-list as a dependency and provides a complete sidebar layout. For custom implementations, you can use thread-list directly.

Getting Started

Add the component

Use threadlist-sidebar for a complete sidebar layout or thread-list for custom layouts.

ThreadListSidebar

npx shadcn@latest add @assistant-ui/threadlist-sidebar

Main Component

import * as React from "react";import { Github, MessagesSquare } from "lucide-react";import Link from "next/link";import {  Sidebar,  SidebarContent,  SidebarFooter,  SidebarHeader,  SidebarMenu,  SidebarMenuButton,  SidebarMenuItem,  SidebarRail,} from "@/components/ui/sidebar";import { ThreadList } from "@/components/assistant-ui/thread-list";export function ThreadListSidebar({  ...props}: React.ComponentProps<typeof Sidebar>) {  return (    <Sidebar {...props}>      <SidebarHeader className="aui-sidebar-header mb-2 border-b">        <div className="aui-sidebar-header-content flex items-center justify-between">          <SidebarMenu>            <SidebarMenuItem>              <SidebarMenuButton size="lg" asChild>                <Link                  href="https://assistant-ui.com"                  target="_blank"                  rel="noopener noreferrer"                >                  <div className="aui-sidebar-header-icon-wrapper flex aspect-square size-8 items-center justify-center rounded-lg bg-sidebar-primary text-sidebar-primary-foreground">                    <MessagesSquare className="aui-sidebar-header-icon size-4" />                  </div>                  <div className="aui-sidebar-header-heading mr-6 flex flex-col gap-0.5 leading-none">                    <span className="aui-sidebar-header-title font-semibold">                      assistant-ui                    </span>                  </div>                </Link>              </SidebarMenuButton>            </SidebarMenuItem>          </SidebarMenu>        </div>      </SidebarHeader>      <SidebarContent className="aui-sidebar-content px-2">        <ThreadList />      </SidebarContent>      <SidebarRail />      <SidebarFooter className="aui-sidebar-footer border-t">        <SidebarMenu>          <SidebarMenuItem>            <SidebarMenuButton size="lg" asChild>              <Link                href="https://github.com/assistant-ui/assistant-ui"                target="_blank"              >                <div className="aui-sidebar-footer-icon-wrapper flex aspect-square size-8 items-center justify-center rounded-lg bg-sidebar-primary text-sidebar-primary-foreground">                  <Github className="aui-sidebar-footer-icon size-4" />                </div>                <div className="aui-sidebar-footer-heading flex flex-col gap-0.5 leading-none">                  <span className="aui-sidebar-footer-title font-semibold">                    GitHub                  </span>                  <span>View Source</span>                </div>              </Link>            </SidebarMenuButton>          </SidebarMenuItem>        </SidebarMenu>      </SidebarFooter>    </Sidebar>  );}

assistant-ui dependencies

npm install @assistant-ui/react
yarn add @assistant-ui/react
pnpm add @assistant-ui/react
bun add @assistant-ui/react
xpm add @assistant-ui/react
import { Button } from "@/components/ui/button";import { Skeleton } from "@/components/ui/skeleton";import {  AssistantIf,  ThreadListItemMorePrimitive,  ThreadListItemPrimitive,  ThreadListPrimitive,} from "@assistant-ui/react";import { ArchiveIcon, MoreHorizontalIcon, PlusIcon } from "lucide-react";import type { FC } from "react";export const ThreadList: FC = () => {  return (    <ThreadListPrimitive.Root className="aui-root aui-thread-list-root flex flex-col gap-1">      <ThreadListNew />      <AssistantIf condition={({ threads }) => threads.isLoading}>        <ThreadListSkeleton />      </AssistantIf>      <AssistantIf condition={({ threads }) => !threads.isLoading}>        <ThreadListPrimitive.Items components={{ ThreadListItem }} />      </AssistantIf>    </ThreadListPrimitive.Root>  );};const ThreadListNew: FC = () => {  return (    <ThreadListPrimitive.New asChild>      <Button        variant="outline"        className="aui-thread-list-new h-9 justify-start gap-2 rounded-lg px-3 text-sm hover:bg-muted data-active:bg-muted"      >        <PlusIcon className="size-4" />        New Thread      </Button>    </ThreadListPrimitive.New>  );};const ThreadListSkeleton: FC = () => {  return (    <div className="flex flex-col gap-1">      {Array.from({ length: 5 }, (_, i) => (        <div          key={i}          role="status"          aria-label="Loading threads"          className="aui-thread-list-skeleton-wrapper flex h-9 items-center px-3"        >          <Skeleton className="aui-thread-list-skeleton h-4 w-full" />        </div>      ))}    </div>  );};const ThreadListItem: FC = () => {  return (    <ThreadListItemPrimitive.Root className="aui-thread-list-item group flex h-9 items-center gap-2 rounded-lg transition-colors hover:bg-muted focus-visible:bg-muted focus-visible:outline-none data-active:bg-muted">      <ThreadListItemPrimitive.Trigger className="aui-thread-list-item-trigger flex h-full min-w-0 flex-1 items-center truncate px-3 text-start text-sm">        <ThreadListItemPrimitive.Title fallback="New Chat" />      </ThreadListItemPrimitive.Trigger>      <ThreadListItemMore />    </ThreadListItemPrimitive.Root>  );};const ThreadListItemMore: FC = () => {  return (    <ThreadListItemMorePrimitive.Root>      <ThreadListItemMorePrimitive.Trigger asChild>        <Button          variant="ghost"          size="icon"          className="aui-thread-list-item-more mr-2 size-7 p-0 opacity-0 transition-opacity group-hover:opacity-100 data-[state=open]:bg-accent data-[state=open]:opacity-100 group-data-active:opacity-100"        >          <MoreHorizontalIcon className="size-4" />          <span className="sr-only">More options</span>        </Button>      </ThreadListItemMorePrimitive.Trigger>      <ThreadListItemMorePrimitive.Content        side="bottom"        align="start"        className="aui-thread-list-item-more-content z-50 min-w-32 overflow-hidden rounded-md border bg-popover p-1 text-popover-foreground shadow-md"      >        <ThreadListItemPrimitive.Archive asChild>          <ThreadListItemMorePrimitive.Item className="aui-thread-list-item-more-item flex cursor-pointer select-none items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none hover:bg-accent hover:text-accent-foreground focus:bg-accent focus:text-accent-foreground">            <ArchiveIcon className="size-4" />            Archive          </ThreadListItemMorePrimitive.Item>        </ThreadListItemPrimitive.Archive>      </ThreadListItemMorePrimitive.Content>    </ThreadListItemMorePrimitive.Root>  );};
"use client";import { ComponentPropsWithRef, forwardRef } from "react";import { Slottable } from "@radix-ui/react-slot";import {  Tooltip,  TooltipContent,  TooltipTrigger,} from "@/components/ui/tooltip";import { Button } from "@/components/ui/button";import { cn } from "@/lib/utils";export type TooltipIconButtonProps = ComponentPropsWithRef<typeof Button> & {  tooltip: string;  side?: "top" | "bottom" | "left" | "right";};export const TooltipIconButton = forwardRef<  HTMLButtonElement,  TooltipIconButtonProps>(({ children, tooltip, side = "bottom", className, ...rest }, ref) => {  return (    <Tooltip>      <TooltipTrigger asChild>        <Button          variant="ghost"          size="icon"          {...rest}          className={cn("aui-button-icon size-6 p-1", className)}          ref={ref}        >          <Slottable>{children}</Slottable>          <span className="aui-sr-only sr-only">{tooltip}</span>        </Button>      </TooltipTrigger>      <TooltipContent side={side}>{tooltip}</TooltipContent>    </Tooltip>  );});TooltipIconButton.displayName = "TooltipIconButton";

shadcn/ui dependencies

npm install @radix-ui/react-slot @radix-ui/react-tooltip
yarn add @radix-ui/react-slot @radix-ui/react-tooltip
pnpm add @radix-ui/react-slot @radix-ui/react-tooltip
bun add @radix-ui/react-slot @radix-ui/react-tooltip
xpm add @radix-ui/react-slot @radix-ui/react-tooltip
"use client";import * as React from "react";import { Slot } from "@radix-ui/react-slot";import { cva, type VariantProps } from "class-variance-authority";import { PanelLeftIcon } from "lucide-react";import { useIsMobile } from "@/hooks/use-mobile";import { cn } from "@/lib/utils";import { Button } from "@/components/ui/button";import { Input } from "@/components/ui/input";import { Separator } from "@/components/ui/separator";import {  Sheet,  SheetContent,  SheetDescription,  SheetHeader,  SheetTitle,} from "@/components/ui/sheet";import { Skeleton } from "@/components/ui/skeleton";import {  Tooltip,  TooltipContent,  TooltipProvider,  TooltipTrigger,} from "@/components/ui/tooltip";const SIDEBAR_COOKIE_NAME = "sidebar_state";const SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7;const SIDEBAR_WIDTH = "16rem";const SIDEBAR_WIDTH_MOBILE = "18rem";const SIDEBAR_WIDTH_ICON = "3rem";const SIDEBAR_KEYBOARD_SHORTCUT = "b";type SidebarContextProps = {  state: "expanded" | "collapsed";  open: boolean;  setOpen: (open: boolean) => void;  openMobile: boolean;  setOpenMobile: (open: boolean) => void;  isMobile: boolean;  toggleSidebar: () => void;};const SidebarContext = React.createContext<SidebarContextProps | null>(null);function useSidebar() {  const context = React.useContext(SidebarContext);  if (!context) {    throw new Error("useSidebar must be used within a SidebarProvider.");  }  return context;}function SidebarProvider({  defaultOpen = true,  open: openProp,  onOpenChange: setOpenProp,  className,  style,  children,  ...props}: React.ComponentProps<"div"> & {  defaultOpen?: boolean;  open?: boolean;  onOpenChange?: (open: boolean) => void;}) {  const isMobile = useIsMobile();  const [openMobile, setOpenMobile] = React.useState(false);  // This is the internal state of the sidebar.  // We use openProp and setOpenProp for control from outside the component.  const [_open, _setOpen] = React.useState(defaultOpen);  const open = openProp ?? _open;  const setOpen = React.useCallback(    (value: boolean | ((value: boolean) => boolean)) => {      const openState = typeof value === "function" ? value(open) : value;      if (setOpenProp) {        setOpenProp(openState);      } else {        _setOpen(openState);      }      // This sets the cookie to keep the sidebar state.      document.cookie = `${SIDEBAR_COOKIE_NAME}=${openState}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`;    },    [setOpenProp, open],  );  // Helper to toggle the sidebar.  const toggleSidebar = React.useCallback(() => {    return isMobile ? setOpenMobile((open) => !open) : setOpen((open) => !open);  }, [isMobile, setOpen, setOpenMobile]);  // Adds a keyboard shortcut to toggle the sidebar.  React.useEffect(() => {    const handleKeyDown = (event: KeyboardEvent) => {      if (        event.key === SIDEBAR_KEYBOARD_SHORTCUT &&        (event.metaKey || event.ctrlKey)      ) {        event.preventDefault();        toggleSidebar();      }    };    window.addEventListener("keydown", handleKeyDown);    return () => window.removeEventListener("keydown", handleKeyDown);  }, [toggleSidebar]);  // We add a state so that we can do data-state="expanded" or "collapsed".  // This makes it easier to style the sidebar with Tailwind classes.  const state = open ? "expanded" : "collapsed";  const contextValue = React.useMemo<SidebarContextProps>(    () => ({      state,      open,      setOpen,      isMobile,      openMobile,      setOpenMobile,      toggleSidebar,    }),    [state, open, setOpen, isMobile, openMobile, setOpenMobile, toggleSidebar],  );  return (    <SidebarContext.Provider value={contextValue}>      <TooltipProvider delayDuration={0}>        <div          data-slot="sidebar-wrapper"          style={            {              "--sidebar-width": SIDEBAR_WIDTH,              "--sidebar-width-icon": SIDEBAR_WIDTH_ICON,              ...style,            } as React.CSSProperties          }          className={cn(            "group/sidebar-wrapper flex min-h-svh w-full has-data-[variant=inset]:bg-sidebar",            className,          )}          {...props}        >          {children}        </div>      </TooltipProvider>    </SidebarContext.Provider>  );}function Sidebar({  side = "left",  variant = "sidebar",  collapsible = "offcanvas",  className,  children,  ...props}: React.ComponentProps<"div"> & {  side?: "left" | "right";  variant?: "sidebar" | "floating" | "inset";  collapsible?: "offcanvas" | "icon" | "none";}) {  const { isMobile, state, openMobile, setOpenMobile } = useSidebar();  if (collapsible === "none") {    return (      <div        data-slot="sidebar"        className={cn(          "flex h-full w-(--sidebar-width) flex-col bg-sidebar text-sidebar-foreground",          className,        )}        {...props}      >        {children}      </div>    );  }  if (isMobile) {    return (      <Sheet open={openMobile} onOpenChange={setOpenMobile} {...props}>        <SheetContent          data-sidebar="sidebar"          data-slot="sidebar"          data-mobile="true"          className="w-(--sidebar-width) bg-sidebar p-0 text-sidebar-foreground [&>button]:hidden"          style={            {              "--sidebar-width": SIDEBAR_WIDTH_MOBILE,            } as React.CSSProperties          }          side={side}        >          <SheetHeader className="sr-only">            <SheetTitle>Sidebar</SheetTitle>            <SheetDescription>Displays the mobile sidebar.</SheetDescription>          </SheetHeader>          <div className="flex h-full w-full flex-col">{children}</div>        </SheetContent>      </Sheet>    );  }  return (    <div      className="group peer hidden text-sidebar-foreground md:block"      data-state={state}      data-collapsible={state === "collapsed" ? collapsible : ""}      data-variant={variant}      data-side={side}      data-slot="sidebar"    >      {/* This is what handles the sidebar gap on desktop */}      <div        data-slot="sidebar-gap"        className={cn(          "relative w-(--sidebar-width) bg-transparent transition-[width] duration-200 ease-linear",          "group-data-[collapsible=offcanvas]:w-0",          "group-data-[side=right]:rotate-180",          variant === "floating" || variant === "inset"            ? "group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4)))]"            : "group-data-[collapsible=icon]:w-(--sidebar-width-icon)",        )}      />      <div        data-slot="sidebar-container"        className={cn(          "fixed inset-y-0 z-10 hidden h-svh w-(--sidebar-width) transition-[left,right,width] duration-200 ease-linear md:flex",          side === "left"            ? "left-0 group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)]"            : "right-0 group-data-[collapsible=offcanvas]:right-[calc(var(--sidebar-width)*-1)]",          // Adjust the padding for floating and inset variants.          variant === "floating" || variant === "inset"            ? "p-2 group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4))+2px)]"            : "group-data-[collapsible=icon]:w-(--sidebar-width-icon) group-data-[side=left]:border-r group-data-[side=right]:border-l",          className,        )}        {...props}      >        <div          data-sidebar="sidebar"          data-slot="sidebar-inner"          className="flex h-full w-full flex-col bg-sidebar group-data-[variant=floating]:rounded-lg group-data-[variant=floating]:border group-data-[variant=floating]:border-sidebar-border group-data-[variant=floating]:shadow-sm"        >          {children}        </div>      </div>    </div>  );}function SidebarTrigger({  className,  onClick,  ...props}: React.ComponentProps<typeof Button>) {  const { toggleSidebar } = useSidebar();  return (    <Button      data-sidebar="trigger"      data-slot="sidebar-trigger"      variant="ghost"      size="icon"      className={cn("size-7", className)}      onClick={(event) => {        onClick?.(event);        toggleSidebar();      }}      {...props}    >      <PanelLeftIcon />      <span className="sr-only">Toggle Sidebar</span>    </Button>  );}function SidebarRail({ className, ...props }: React.ComponentProps<"button">) {  const { toggleSidebar } = useSidebar();  return (    <button      data-sidebar="rail"      data-slot="sidebar-rail"      aria-label="Toggle Sidebar"      tabIndex={-1}      onClick={toggleSidebar}      title="Toggle Sidebar"      className={cn(        "absolute inset-y-0 z-20 hidden w-4 -translate-x-1/2 transition-all ease-linear after:absolute after:inset-y-0 after:left-1/2 after:w-[2px] hover:after:bg-sidebar-border group-data-[side=left]:-right-4 group-data-[side=right]:left-0 sm:flex",        "in-data-[side=left]:cursor-w-resize in-data-[side=right]:cursor-e-resize",        "[[data-side=left][data-state=collapsed]_&]:cursor-e-resize [[data-side=right][data-state=collapsed]_&]:cursor-w-resize",        "group-data-[collapsible=offcanvas]:translate-x-0 hover:group-data-[collapsible=offcanvas]:bg-sidebar group-data-[collapsible=offcanvas]:after:left-full",        "[[data-side=left][data-collapsible=offcanvas]_&]:-right-2",        "[[data-side=right][data-collapsible=offcanvas]_&]:-left-2",        className,      )}      {...props}    />  );}function SidebarInset({ className, ...props }: React.ComponentProps<"main">) {  return (    <main      data-slot="sidebar-inset"      className={cn(        "relative flex w-full flex-1 flex-col bg-background",        "md:peer-data-[variant=inset]:peer-data-[state=collapsed]:ml-2 md:peer-data-[variant=inset]:m-2 md:peer-data-[variant=inset]:ml-0 md:peer-data-[variant=inset]:rounded-xl md:peer-data-[variant=inset]:shadow-sm",        className,      )}      {...props}    />  );}function SidebarInput({  className,  ...props}: React.ComponentProps<typeof Input>) {  return (    <Input      data-slot="sidebar-input"      data-sidebar="input"      className={cn("h-8 w-full bg-background shadow-none", className)}      {...props}    />  );}function SidebarHeader({ className, ...props }: React.ComponentProps<"div">) {  return (    <div      data-slot="sidebar-header"      data-sidebar="header"      className={cn("flex flex-col gap-2 p-2", className)}      {...props}    />  );}function SidebarFooter({ className, ...props }: React.ComponentProps<"div">) {  return (    <div      data-slot="sidebar-footer"      data-sidebar="footer"      className={cn("flex flex-col gap-2 p-2", className)}      {...props}    />  );}function SidebarSeparator({  className,  ...props}: React.ComponentProps<typeof Separator>) {  return (    <Separator      data-slot="sidebar-separator"      data-sidebar="separator"      className={cn("mx-2 w-auto bg-sidebar-border", className)}      {...props}    />  );}function SidebarContent({ className, ...props }: React.ComponentProps<"div">) {  return (    <div      data-slot="sidebar-content"      data-sidebar="content"      className={cn(        "flex min-h-0 flex-1 flex-col gap-2 overflow-auto group-data-[collapsible=icon]:overflow-hidden",        className,      )}      {...props}    />  );}function SidebarGroup({ className, ...props }: React.ComponentProps<"div">) {  return (    <div      data-slot="sidebar-group"      data-sidebar="group"      className={cn("relative flex w-full min-w-0 flex-col p-2", className)}      {...props}    />  );}function SidebarGroupLabel({  className,  asChild = false,  ...props}: React.ComponentProps<"div"> & { asChild?: boolean }) {  const Comp = asChild ? Slot : "div";  return (    <Comp      data-slot="sidebar-group-label"      data-sidebar="group-label"      className={cn(        "flex h-8 shrink-0 items-center rounded-md px-2 font-medium text-sidebar-foreground/70 text-xs outline-hidden ring-sidebar-ring transition-[margin,opacity] duration-200 ease-linear focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0",        "group-data-[collapsible=icon]:-mt-8 group-data-[collapsible=icon]:opacity-0",        className,      )}      {...props}    />  );}function SidebarGroupAction({  className,  asChild = false,  ...props}: React.ComponentProps<"button"> & { asChild?: boolean }) {  const Comp = asChild ? Slot : "button";  return (    <Comp      data-slot="sidebar-group-action"      data-sidebar="group-action"      className={cn(        "absolute top-3.5 right-3 flex aspect-square w-5 items-center justify-center rounded-md p-0 text-sidebar-foreground outline-hidden ring-sidebar-ring transition-transform hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0",        // Increases the hit area of the button on mobile.        "after:absolute after:-inset-2 md:after:hidden",        "group-data-[collapsible=icon]:hidden",        className,      )}      {...props}    />  );}function SidebarGroupContent({  className,  ...props}: React.ComponentProps<"div">) {  return (    <div      data-slot="sidebar-group-content"      data-sidebar="group-content"      className={cn("w-full text-sm", className)}      {...props}    />  );}function SidebarMenu({ className, ...props }: React.ComponentProps<"ul">) {  return (    <ul      data-slot="sidebar-menu"      data-sidebar="menu"      className={cn("flex w-full min-w-0 flex-col gap-1", className)}      {...props}    />  );}function SidebarMenuItem({ className, ...props }: React.ComponentProps<"li">) {  return (    <li      data-slot="sidebar-menu-item"      data-sidebar="menu-item"      className={cn("group/menu-item relative", className)}      {...props}    />  );}const sidebarMenuButtonVariants = cva(  "peer/menu-button flex w-full items-center gap-2 overflow-hidden rounded-md p-2 text-left text-sm outline-hidden ring-sidebar-ring transition-[width,height,padding] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 active:bg-sidebar-accent active:text-sidebar-accent-foreground disabled:pointer-events-none disabled:opacity-50 group-has-data-[sidebar=menu-action]/menu-item:pr-8 aria-disabled:pointer-events-none aria-disabled:opacity-50 data-[active=true]:bg-sidebar-accent data-[active=true]:font-medium data-[active=true]:text-sidebar-accent-foreground data-[state=open]:hover:bg-sidebar-accent data-[state=open]:hover:text-sidebar-accent-foreground group-data-[collapsible=icon]:size-8! group-data-[collapsible=icon]:p-2! [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0",  {    variants: {      variant: {        default: "hover:bg-sidebar-accent hover:text-sidebar-accent-foreground",        outline:          "bg-background shadow-[0_0_0_1px_hsl(var(--sidebar-border))] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground hover:shadow-[0_0_0_1px_hsl(var(--sidebar-accent))]",      },      size: {        default: "h-8 text-sm",        sm: "h-7 text-xs",        lg: "h-12 text-sm group-data-[collapsible=icon]:p-0!",      },    },    defaultVariants: {      variant: "default",      size: "default",    },  },);function SidebarMenuButton({  asChild = false,  isActive = false,  variant = "default",  size = "default",  tooltip,  className,  ...props}: React.ComponentProps<"button"> & {  asChild?: boolean;  isActive?: boolean;  tooltip?: string | React.ComponentProps<typeof TooltipContent>;} & VariantProps<typeof sidebarMenuButtonVariants>) {  const Comp = asChild ? Slot : "button";  const { isMobile, state } = useSidebar();  const button = (    <Comp      data-slot="sidebar-menu-button"      data-sidebar="menu-button"      data-size={size}      data-active={isActive}      className={cn(sidebarMenuButtonVariants({ variant, size }), className)}      {...props}    />  );  if (!tooltip) {    return button;  }  if (typeof tooltip === "string") {    tooltip = {      children: tooltip,    };  }  return (    <Tooltip>      <TooltipTrigger asChild>{button}</TooltipTrigger>      <TooltipContent        side="right"        align="center"        hidden={state !== "collapsed" || isMobile}        {...tooltip}      />    </Tooltip>  );}function SidebarMenuAction({  className,  asChild = false,  showOnHover = false,  ...props}: React.ComponentProps<"button"> & {  asChild?: boolean;  showOnHover?: boolean;}) {  const Comp = asChild ? Slot : "button";  return (    <Comp      data-slot="sidebar-menu-action"      data-sidebar="menu-action"      className={cn(        "absolute top-1.5 right-1 flex aspect-square w-5 items-center justify-center rounded-md p-0 text-sidebar-foreground outline-hidden ring-sidebar-ring transition-transform hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 peer-hover/menu-button:text-sidebar-accent-foreground [&>svg]:size-4 [&>svg]:shrink-0",        // Increases the hit area of the button on mobile.        "after:absolute after:-inset-2 md:after:hidden",        "peer-data-[size=sm]/menu-button:top-1",        "peer-data-[size=default]/menu-button:top-1.5",        "peer-data-[size=lg]/menu-button:top-2.5",        "group-data-[collapsible=icon]:hidden",        showOnHover &&          "group-focus-within/menu-item:opacity-100 group-hover/menu-item:opacity-100 data-[state=open]:opacity-100 peer-data-[active=true]/menu-button:text-sidebar-accent-foreground md:opacity-0",        className,      )}      {...props}    />  );}function SidebarMenuBadge({  className,  ...props}: React.ComponentProps<"div">) {  return (    <div      data-slot="sidebar-menu-badge"      data-sidebar="menu-badge"      className={cn(        "pointer-events-none absolute right-1 flex h-5 min-w-5 select-none items-center justify-center rounded-md px-1 font-medium text-sidebar-foreground text-xs tabular-nums",        "peer-hover/menu-button:text-sidebar-accent-foreground peer-data-[active=true]/menu-button:text-sidebar-accent-foreground",        "peer-data-[size=sm]/menu-button:top-1",        "peer-data-[size=default]/menu-button:top-1.5",        "peer-data-[size=lg]/menu-button:top-2.5",        "group-data-[collapsible=icon]:hidden",        className,      )}      {...props}    />  );}function SidebarMenuSkeleton({  className,  showIcon = false,  ...props}: React.ComponentProps<"div"> & {  showIcon?: boolean;}) {  // Random width between 50 to 90%.  const width = React.useMemo(() => {    return `${Math.floor(Math.random() * 40) + 50}%`;  }, []);  return (    <div      data-slot="sidebar-menu-skeleton"      data-sidebar="menu-skeleton"      className={cn("flex h-8 items-center gap-2 rounded-md px-2", className)}      {...props}    >      {showIcon && (        <Skeleton          className="size-4 rounded-md"          data-sidebar="menu-skeleton-icon"        />      )}      <Skeleton        className="h-4 max-w-(--skeleton-width) flex-1"        data-sidebar="menu-skeleton-text"        style={          {            "--skeleton-width": width,          } as React.CSSProperties        }      />    </div>  );}function SidebarMenuSub({ className, ...props }: React.ComponentProps<"ul">) {  return (    <ul      data-slot="sidebar-menu-sub"      data-sidebar="menu-sub"      className={cn(        "mx-3.5 flex min-w-0 translate-x-px flex-col gap-1 border-sidebar-border border-l px-2.5 py-0.5",        "group-data-[collapsible=icon]:hidden",        className,      )}      {...props}    />  );}function SidebarMenuSubItem({  className,  ...props}: React.ComponentProps<"li">) {  return (    <li      data-slot="sidebar-menu-sub-item"      data-sidebar="menu-sub-item"      className={cn("group/menu-sub-item relative", className)}      {...props}    />  );}function SidebarMenuSubButton({  asChild = false,  size = "md",  isActive = false,  className,  ...props}: React.ComponentProps<"a"> & {  asChild?: boolean;  size?: "sm" | "md";  isActive?: boolean;}) {  const Comp = asChild ? Slot : "a";  return (    <Comp      data-slot="sidebar-menu-sub-button"      data-sidebar="menu-sub-button"      data-size={size}      data-active={isActive}      className={cn(        "flex h-7 min-w-0 -translate-x-px items-center gap-2 overflow-hidden rounded-md px-2 text-sidebar-foreground outline-hidden ring-sidebar-ring hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 active:bg-sidebar-accent active:text-sidebar-accent-foreground disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0 [&>svg]:text-sidebar-accent-foreground",        "data-[active=true]:bg-sidebar-accent data-[active=true]:text-sidebar-accent-foreground",        size === "sm" && "text-xs",        size === "md" && "text-sm",        "group-data-[collapsible=icon]:hidden",        className,      )}      {...props}    />  );}export {  Sidebar,  SidebarContent,  SidebarFooter,  SidebarGroup,  SidebarGroupAction,  SidebarGroupContent,  SidebarGroupLabel,  SidebarHeader,  SidebarInput,  SidebarInset,  SidebarMenu,  SidebarMenuAction,  SidebarMenuBadge,  SidebarMenuButton,  SidebarMenuItem,  SidebarMenuSkeleton,  SidebarMenuSub,  SidebarMenuSubButton,  SidebarMenuSubItem,  SidebarProvider,  SidebarRail,  SidebarSeparator,  SidebarTrigger,  useSidebar,};
import * as React from "react";import { Slot } from "@radix-ui/react-slot";import { cva, type VariantProps } from "class-variance-authority";import { cn } from "@/lib/utils";const buttonVariants = cva(  "inline-flex shrink-0 items-center justify-center gap-2 whitespace-nowrap rounded-md font-medium text-sm outline-none transition-all focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&_svg:not([class*='size-'])]:size-4 [&_svg]:pointer-events-none [&_svg]:shrink-0",  {    variants: {      variant: {        default: "bg-primary text-primary-foreground hover:bg-primary/90",        destructive:          "bg-destructive text-white hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:bg-destructive/60 dark:focus-visible:ring-destructive/40",        outline:          "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",        secondary:          "bg-secondary text-secondary-foreground hover:bg-secondary/80",        ghost:          "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",        link: "text-primary underline-offset-4 hover:underline",      },      size: {        default: "h-9 px-4 py-2 has-[>svg]:px-3",        sm: "h-8 gap-1.5 rounded-md px-3 has-[>svg]:px-2.5",        lg: "h-10 rounded-md px-6 has-[>svg]:px-4",        icon: "size-9",        "icon-sm": "size-8",        "icon-lg": "size-10",      },    },    defaultVariants: {      variant: "default",      size: "default",    },  },);function Button({  className,  variant = "default",  size = "default",  asChild = false,  ...props}: React.ComponentProps<"button"> &  VariantProps<typeof buttonVariants> & {    asChild?: boolean;  }) {  const Comp = asChild ? Slot : "button";  return (    <Comp      data-slot="button"      data-variant={variant}      data-size={size}      className={cn(buttonVariants({ variant, size, className }))}      {...props}    />  );}export { Button, buttonVariants };
import { cn } from "@/lib/utils";function Skeleton({ className, ...props }: React.ComponentProps<"div">) {  return (    <div      data-slot="skeleton"      className={cn("animate-pulse rounded-md bg-accent", className)}      {...props}    />  );}export { Skeleton };
"use client";import * as React from "react";import * as TooltipPrimitive from "@radix-ui/react-tooltip";import { cn } from "@/lib/utils";function TooltipProvider({  delayDuration = 0,  ...props}: React.ComponentProps<typeof TooltipPrimitive.Provider>) {  return (    <TooltipPrimitive.Provider      data-slot="tooltip-provider"      delayDuration={delayDuration}      {...props}    />  );}function Tooltip({  ...props}: React.ComponentProps<typeof TooltipPrimitive.Root>) {  return (    <TooltipProvider>      <TooltipPrimitive.Root data-slot="tooltip" {...props} />    </TooltipProvider>  );}function TooltipTrigger({  ...props}: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />;}function TooltipContent({  className,  sideOffset = 0,  children,  ...props}: React.ComponentProps<typeof TooltipPrimitive.Content>) {  return (    <TooltipPrimitive.Portal>      <TooltipPrimitive.Content        data-slot="tooltip-content"        sideOffset={sideOffset}        className={cn(          "fade-in-0 zoom-in-95 data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-fit origin-(--radix-tooltip-content-transform-origin) animate-in text-balance rounded-md bg-foreground px-3 py-1.5 text-background text-xs data-[state=closed]:animate-out",          className,        )}        {...props}      >        {children}        <TooltipPrimitive.Arrow className="z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground" />      </TooltipPrimitive.Content>    </TooltipPrimitive.Portal>  );}export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

ThreadList

npx shadcn@latest add @assistant-ui/thread-list

Main Component

npm install @assistant-ui/react
yarn add @assistant-ui/react
pnpm add @assistant-ui/react
bun add @assistant-ui/react
xpm add @assistant-ui/react
import { Button } from "@/components/ui/button";import { Skeleton } from "@/components/ui/skeleton";import {  AssistantIf,  ThreadListItemMorePrimitive,  ThreadListItemPrimitive,  ThreadListPrimitive,} from "@assistant-ui/react";import { ArchiveIcon, MoreHorizontalIcon, PlusIcon } from "lucide-react";import type { FC } from "react";export const ThreadList: FC = () => {  return (    <ThreadListPrimitive.Root className="aui-root aui-thread-list-root flex flex-col gap-1">      <ThreadListNew />      <AssistantIf condition={({ threads }) => threads.isLoading}>        <ThreadListSkeleton />      </AssistantIf>      <AssistantIf condition={({ threads }) => !threads.isLoading}>        <ThreadListPrimitive.Items components={{ ThreadListItem }} />      </AssistantIf>    </ThreadListPrimitive.Root>  );};const ThreadListNew: FC = () => {  return (    <ThreadListPrimitive.New asChild>      <Button        variant="outline"        className="aui-thread-list-new h-9 justify-start gap-2 rounded-lg px-3 text-sm hover:bg-muted data-active:bg-muted"      >        <PlusIcon className="size-4" />        New Thread      </Button>    </ThreadListPrimitive.New>  );};const ThreadListSkeleton: FC = () => {  return (    <div className="flex flex-col gap-1">      {Array.from({ length: 5 }, (_, i) => (        <div          key={i}          role="status"          aria-label="Loading threads"          className="aui-thread-list-skeleton-wrapper flex h-9 items-center px-3"        >          <Skeleton className="aui-thread-list-skeleton h-4 w-full" />        </div>      ))}    </div>  );};const ThreadListItem: FC = () => {  return (    <ThreadListItemPrimitive.Root className="aui-thread-list-item group flex h-9 items-center gap-2 rounded-lg transition-colors hover:bg-muted focus-visible:bg-muted focus-visible:outline-none data-active:bg-muted">      <ThreadListItemPrimitive.Trigger className="aui-thread-list-item-trigger flex h-full min-w-0 flex-1 items-center truncate px-3 text-start text-sm">        <ThreadListItemPrimitive.Title fallback="New Chat" />      </ThreadListItemPrimitive.Trigger>      <ThreadListItemMore />    </ThreadListItemPrimitive.Root>  );};const ThreadListItemMore: FC = () => {  return (    <ThreadListItemMorePrimitive.Root>      <ThreadListItemMorePrimitive.Trigger asChild>        <Button          variant="ghost"          size="icon"          className="aui-thread-list-item-more mr-2 size-7 p-0 opacity-0 transition-opacity group-hover:opacity-100 data-[state=open]:bg-accent data-[state=open]:opacity-100 group-data-active:opacity-100"        >          <MoreHorizontalIcon className="size-4" />          <span className="sr-only">More options</span>        </Button>      </ThreadListItemMorePrimitive.Trigger>      <ThreadListItemMorePrimitive.Content        side="bottom"        align="start"        className="aui-thread-list-item-more-content z-50 min-w-32 overflow-hidden rounded-md border bg-popover p-1 text-popover-foreground shadow-md"      >        <ThreadListItemPrimitive.Archive asChild>          <ThreadListItemMorePrimitive.Item className="aui-thread-list-item-more-item flex cursor-pointer select-none items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none hover:bg-accent hover:text-accent-foreground focus:bg-accent focus:text-accent-foreground">            <ArchiveIcon className="size-4" />            Archive          </ThreadListItemMorePrimitive.Item>        </ThreadListItemPrimitive.Archive>      </ThreadListItemMorePrimitive.Content>    </ThreadListItemMorePrimitive.Root>  );};

assistant-ui dependencies

"use client";import { ComponentPropsWithRef, forwardRef } from "react";import { Slottable } from "@radix-ui/react-slot";import {  Tooltip,  TooltipContent,  TooltipTrigger,} from "@/components/ui/tooltip";import { Button } from "@/components/ui/button";import { cn } from "@/lib/utils";export type TooltipIconButtonProps = ComponentPropsWithRef<typeof Button> & {  tooltip: string;  side?: "top" | "bottom" | "left" | "right";};export const TooltipIconButton = forwardRef<  HTMLButtonElement,  TooltipIconButtonProps>(({ children, tooltip, side = "bottom", className, ...rest }, ref) => {  return (    <Tooltip>      <TooltipTrigger asChild>        <Button          variant="ghost"          size="icon"          {...rest}          className={cn("aui-button-icon size-6 p-1", className)}          ref={ref}        >          <Slottable>{children}</Slottable>          <span className="aui-sr-only sr-only">{tooltip}</span>        </Button>      </TooltipTrigger>      <TooltipContent side={side}>{tooltip}</TooltipContent>    </Tooltip>  );});TooltipIconButton.displayName = "TooltipIconButton";

shadcn/ui dependencies

npm install @radix-ui/react-slot @radix-ui/react-tooltip
yarn add @radix-ui/react-slot @radix-ui/react-tooltip
pnpm add @radix-ui/react-slot @radix-ui/react-tooltip
bun add @radix-ui/react-slot @radix-ui/react-tooltip
xpm add @radix-ui/react-slot @radix-ui/react-tooltip
import * as React from "react";import { Slot } from "@radix-ui/react-slot";import { cva, type VariantProps } from "class-variance-authority";import { cn } from "@/lib/utils";const buttonVariants = cva(  "inline-flex shrink-0 items-center justify-center gap-2 whitespace-nowrap rounded-md font-medium text-sm outline-none transition-all focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&_svg:not([class*='size-'])]:size-4 [&_svg]:pointer-events-none [&_svg]:shrink-0",  {    variants: {      variant: {        default: "bg-primary text-primary-foreground hover:bg-primary/90",        destructive:          "bg-destructive text-white hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:bg-destructive/60 dark:focus-visible:ring-destructive/40",        outline:          "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",        secondary:          "bg-secondary text-secondary-foreground hover:bg-secondary/80",        ghost:          "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",        link: "text-primary underline-offset-4 hover:underline",      },      size: {        default: "h-9 px-4 py-2 has-[>svg]:px-3",        sm: "h-8 gap-1.5 rounded-md px-3 has-[>svg]:px-2.5",        lg: "h-10 rounded-md px-6 has-[>svg]:px-4",        icon: "size-9",        "icon-sm": "size-8",        "icon-lg": "size-10",      },    },    defaultVariants: {      variant: "default",      size: "default",    },  },);function Button({  className,  variant = "default",  size = "default",  asChild = false,  ...props}: React.ComponentProps<"button"> &  VariantProps<typeof buttonVariants> & {    asChild?: boolean;  }) {  const Comp = asChild ? Slot : "button";  return (    <Comp      data-slot="button"      data-variant={variant}      data-size={size}      className={cn(buttonVariants({ variant, size, className }))}      {...props}    />  );}export { Button, buttonVariants };
import { cn } from "@/lib/utils";function Skeleton({ className, ...props }: React.ComponentProps<"div">) {  return (    <div      data-slot="skeleton"      className={cn("animate-pulse rounded-md bg-accent", className)}      {...props}    />  );}export { Skeleton };
"use client";import * as React from "react";import * as TooltipPrimitive from "@radix-ui/react-tooltip";import { cn } from "@/lib/utils";function TooltipProvider({  delayDuration = 0,  ...props}: React.ComponentProps<typeof TooltipPrimitive.Provider>) {  return (    <TooltipPrimitive.Provider      data-slot="tooltip-provider"      delayDuration={delayDuration}      {...props}    />  );}function Tooltip({  ...props}: React.ComponentProps<typeof TooltipPrimitive.Root>) {  return (    <TooltipProvider>      <TooltipPrimitive.Root data-slot="tooltip" {...props} />    </TooltipProvider>  );}function TooltipTrigger({  ...props}: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />;}function TooltipContent({  className,  sideOffset = 0,  children,  ...props}: React.ComponentProps<typeof TooltipPrimitive.Content>) {  return (    <TooltipPrimitive.Portal>      <TooltipPrimitive.Content        data-slot="tooltip-content"        sideOffset={sideOffset}        className={cn(          "fade-in-0 zoom-in-95 data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-fit origin-(--radix-tooltip-content-transform-origin) animate-in text-balance rounded-md bg-foreground px-3 py-1.5 text-background text-xs data-[state=closed]:animate-out",          className,        )}        {...props}      >        {children}        <TooltipPrimitive.Arrow className="z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground" />      </TooltipPrimitive.Content>    </TooltipPrimitive.Portal>  );}export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

Use in your application

/app/assistant.tsx
import { Thread } from "@/components/assistant-ui/thread";
import { ThreadListSidebar } from "@/components/assistant-ui/threadlist-sidebar";
import { 
  SidebarProvider, 
  SidebarInset,
  SidebarTrigger 
} from "@/components/ui/sidebar";

export default function Assistant() {
  return (
    <SidebarProvider>
      <div className="flex h-dvh w-full">
        <ThreadListSidebar />
        <SidebarInset>
          {/* Add sidebar trigger, location can be customized */}
          <SidebarTrigger className="absolute top-4 left-4" />
          <Thread />
        </SidebarInset>
      </div>
    </SidebarProvider>
  );
}
/app/assistant.tsx
import { Thread } from "@/components/assistant-ui/thread";
import { ThreadList } from "@/components/assistant-ui/thread-list";

export default function Assistant() {
  return (
    <div className="grid h-full grid-cols-[200px_1fr]">
      <ThreadList />
      <Thread />
    </div>
  );
}