assistant-ui CLI#
Command-line tool for adding shadcn-style components to your project, scaffolding a new app, and keeping your assistant-ui packages up to date.
Installation#
Run via your package manager of choice; nothing to install globally:
npx assistant-ui@latest <command>
pnpm dlx assistant-ui@latest <command>
yarn dlx assistant-ui@latest <command>
bunx assistant-ui@latest <command>
Common tasks#
# scaffold a new Next.js project
npx assistant-ui@latest create my-app
# scaffold a minimal project
npx assistant-ui@latest create my-app --template minimal
# scaffold from a feature example
npx assistant-ui@latest create my-app --example with-ai-sdk-v6
# scaffold an Expo / React Native project
npx assistant-ui@latest create my-app --native
# scaffold a React Ink terminal project
npx assistant-ui@latest create my-app --ink
# add assistant-ui to an existing project
npx assistant-ui@latest init
# initialize non-interactively for CI or agent flows
npx assistant-ui@latest init --yes
# add a component
npx assistant-ui@latest add thread
# update all @assistant-ui/* and assistant-* packages
npx assistant-ui@latest update
# run codemods after a major version bump
npx assistant-ui@latest upgrade
# print env + version info for a bug report
npx assistant-ui info
init falls back to create when no package.json is found, so a single command works for both new and existing projects. Use init --yes for CI and agent flows where prompts are not available.
Templates#
create scaffolds from named templates: default (AI SDK), minimal, cloud, cloud-clerk, langgraph, mcp. Pass -t <name>, pass --example <name> for examples such as with-ai-sdk-v6, use --native for Expo / React Native, use --ink for React Ink, or pass --preset <url> to scaffold from an assistant-ui.com playground link.
Documentation#
Full command reference, flags, and template details at assistant-ui.com/docs/cli.