setup

Installation
Summary

Initialize and configure assistant-ui chat UI in Next.js projects or create new apps from templates.

  • Supports two workflows: init for existing Next.js projects and create for new apps, with six starter templates covering AI SDK, cloud persistence, Clerk auth, LangGraph, and MCP integrations
  • CLI flags enable non-interactive setup (--yes), template selection (-t), preset configuration (--preset), and component registry additions (add)
  • Reference documentation covers advanced runtimes including LangGraph, custom backends, external state management, and non-Next.js frameworks like Vite and TanStack Start
  • Includes component registry for adding pre-built UI elements like markdown text and thread lists
SKILL.md

assistant-ui Setup

CLI Commands

Quick Decision Flow

  • Existing Next.js app (package.json exists): use npx assistant-ui@latest init
  • Existing app in CI/agent/non-interactive shell: use npx assistant-ui@latest init --yes
  • Existing app + force overwrite of conflicts: add --overwrite
  • New app / empty directory: use npx assistant-ui@latest create <name>
  • Need specific starter template: add -t <default|minimal|cloud|cloud-clerk|langgraph|mcp>
  • Need a curated example: use npx assistant-ui@latest create <name> --example <example>
  • Need playground preset config: use npx assistant-ui@latest create <name> --preset <url>

New Project (create)

Related skills
Installs
1.4K
GitHub Stars
15
First Seen
Jan 21, 2026