thread-list

name	thread-list
description	Implements multi-thread (conversation history) management in assistant-ui apps: rendering the prebuilt `ThreadList` next to `Thread`, or building a custom sidebar with `ThreadListPrimitive` and `ThreadListItemPrimitive` (Root, New, Items, Trigger, Title, Archive, Unarchive, Delete). Covers thread CRUD through the `useAui()`/`useAuiState()` API: `switchToThread`, `switchToNewThread`, and per item `rename`, `archive`, `unarchive`, `delete`, `generateTitle`, `initialize`, plus reading `s.threads.threadIds`/`archivedThreadIds`/`mainThreadId`. Includes cloud-backed persistence via `useChatRuntime` + `AssistantCloud` and a local `useRemoteThreadListRuntime` + `InMemoryThreadListAdapter` path. Use when a user wants a thread list/sidebar, switching, searching, sorting, drag-and-drop, or renaming/archiving/deleting conversations. For single-thread state, messages, or composer use runtime; for cloud auth/persistence setup use cloud.
license	MIT

assistant-ui Thread List

Always consult assistant-ui.com/llms.txt for the latest API.

Manage multiple chat threads with built-in or custom UI.

References

• ./references/management.md -- Thread CRUD operations
• ./references/custom-ui.md -- Custom thread list UI

Quick Start

Thread list is available with useChatRuntime + cloud:

import { AssistantCloud }  ;
 { useChatRuntime,  }  ;
 {  }  ;
 {  }  ;
 {  }  ;

 cloud =  ({
  : process..,
  :  () => (),
});

 () {
   runtime = ({
    :  ({ :  }),
    cloud,
  });

   (
    
  );
}