assistant-ui 0.0.90 → 0.0.92

package/README.md

@@ -1,141 +1,65 @@
 # `assistant-ui` CLI
 
-The `assistant-ui` CLI for adding components and dependencies to your project.
+[![npm version](https://img.shields.io/npm/v/assistant-ui)](https://www.npmjs.com/package/assistant-ui)
+[![npm downloads](https://img.shields.io/npm/dm/assistant-ui)](https://www.npmjs.com/package/assistant-ui)
+[![GitHub stars](https://img.shields.io/github/stars/assistant-ui/assistant-ui)](https://github.com/assistant-ui/assistant-ui)
 
-## Usage
+Command-line tool for adding shadcn-style components to your project, scaffolding a new app, and keeping your assistant-ui packages up to date.
 
-Use the `init` command to initialize assistant-ui in an existing project.
+## Installation
 
-The `init` command installs dependencies, adds components, and configures your project for assistant-ui.
+Run via your package manager of choice; nothing to install globally:
 
 ```bash
-npx assistant-ui@latest init
-npx assistant-ui@latest init --yes  # non-interactive / CI / agent mode
+npx assistant-ui@latest <command>
+pnpm dlx assistant-ui@latest <command>
+yarn dlx assistant-ui@latest <command>
+bunx assistant-ui@latest <command>
 ```
 
-If no existing project is found (no `package.json`), `init` forwards to `create`.
-Passing `--preset` to `init` also forwards to `create` for compatibility.
-
-## create
-
-Use the `create` command to scaffold a new Next.js project with assistant-ui.
-
-The `create` command scaffolds a project from assistant-ui starter templates or examples.
+## Common tasks
 
 ```bash
+# scaffold a new Next.js project
 npx assistant-ui@latest create my-app
-```
 
-You can choose from multiple templates:
+# scaffold a minimal project
+npx assistant-ui@latest create my-app --template minimal
 
-```bash
-# Default template with Vercel AI SDK
-npx assistant-ui@latest create my-app
-
-# Minimal starter
-npx assistant-ui@latest create my-app -t minimal
-
-# With Assistant Cloud for persistence
-npx assistant-ui@latest create my-app -t cloud
+# scaffold from a feature example
+npx assistant-ui@latest create my-app --example with-ai-sdk-v6
 
-# With Assistant Cloud + Clerk auth
-npx assistant-ui@latest create my-app -t cloud-clerk
+# scaffold an Expo / React Native project
+npx assistant-ui@latest create my-app --native
 
-# With LangGraph starter template
-npx assistant-ui@latest create my-app -t langgraph
+# scaffold a React Ink terminal project
+npx assistant-ui@latest create my-app --ink
 
-# With MCP starter template
-npx assistant-ui@latest create my-app -t mcp
-
-# With playground preset configuration
-npx assistant-ui@latest create my-app --preset "https://www.assistant-ui.com/playground/init?preset=chatgpt"
-```
-
-## add
-
-Use the `add` command to add components to your project.
-
-The `add` command adds a component to your project and installs all required dependencies.
-
-```bash
-npx assistant-ui@latest add [component]
-```
+# add assistant-ui to an existing project
+npx assistant-ui@latest init
 
-### Example
+# initialize non-interactively for CI or agent flows
+npx assistant-ui@latest init --yes
 
-```bash
+# add a component
 npx assistant-ui@latest add thread
-```
-
-You can also add multiple components at once:
 
-```bash
-npx assistant-ui@latest add thread thread-list assistant-modal
-```
-
-## update
-
-Use the `update` command to update all assistant-ui packages to their latest versions.
-
-```bash
+# update all @assistant-ui/* and assistant-* packages
 npx assistant-ui@latest update
-```
-
-## upgrade
-
-Use the `upgrade` command to automatically migrate your codebase when upgrading to a new major version.
 
-The `upgrade` command runs codemods to transform your code and prompts to install new dependencies.
-
-```bash
+# run codemods after a major version bump
 npx assistant-ui@latest upgrade
-```
-
-## info
-
-Use the `info` command to print your environment and package versions for bug reports.
 
-```bash
+# print env + version info for a bug report
 npx assistant-ui info
 ```
 
-This command collects and prints:
-- OS, Node.js version, package manager, and framework
-- All installed `@assistant-ui/*` and `assistant-*` package versions
-- Key ecosystem dependency versions (React, Next.js, AI SDK, etc.)
-- Peer dependency warnings if any mismatches are detected
-
-**Example output:**
+`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.
 
-```
-Environment:
-  OS:               macOS 15.3 (arm64)
-  Node.js:          v22.14.0
-  Package Manager:  pnpm 10.32.1
-  Framework:        Next.js 15.3.1
-
-Packages:
-  @assistant-ui/react            0.12.15
-  @assistant-ui/react-ai-sdk     1.3.12
-  @assistant-ui/react-markdown   0.3.8
-  assistant-stream                0.2.14
-
-Ecosystem:
-  react      19.1.0
-  react-dom  19.1.0
-  next       15.3.1
-  ai         6.0.120
-```
-
-The output includes a copy-pasteable markdown block that you can paste directly into a bug report.
+## Templates
 
-**Options:**
-- `-c, --cwd <cwd>` - the working directory. defaults to the current directory.
+`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
 
-Visit https://assistant-ui.com/docs/cli to view the full documentation.
-
-## License
-
-Licensed under the [MIT license](https://github.com/assistant-ui/assistant-ui/blob/main/LICENSE).
+Full command reference, flags, and template details at [assistant-ui.com/docs/cli](https://www.assistant-ui.com/docs/cli).

package/dist/commands/add.d.ts

@@ -1,3 +1,16 @@
 import { Command } from "commander";
+import { type PackageManagerName } from "../lib/create-project.js";
+export interface AddComponentsPlan {
+    command: string;
+    args: string[];
+}
+export declare function createAddComponentsPlan(params: {
+    components: string[];
+    packageManager: PackageManagerName;
+    yes?: boolean;
+    overwrite?: boolean;
+    cwd?: string;
+    path?: string;
+}): AddComponentsPlan;
 export declare const add: Command;
 //# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,eAAO,MAAM,GAAG,SAuDZ,CAAC"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAIL,KAAK,kBAAkB,EACxB,iCAA8B;AAK/B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,kBAAkB,CAAC;IACnC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,iBAAiB,CAmBpB;AAED,eAAO,MAAM,GAAG,SAqDZ,CAAC"}

package/dist/commands/add.js

@@ -1,8 +1,30 @@
 import { Command } from "commander";
-import { spawn } from "cross-spawn";
 import { logger } from "../lib/utils/logger.js";
 import { hasConfig } from "../lib/utils/config.js";
+import { dlxCommand, resolvePackageManager, resolvePackageManagerForCwd, } from "../lib/create-project.js";
+import { runSpawn, SpawnExitError } from "../lib/run-spawn.js";
 const REGISTRY_BASE_URL = "https://r.assistant-ui.com";
+export function createAddComponentsPlan(params) {
+    const componentsToAdd = params.components.map((c) => {
+        if (!/^[a-zA-Z0-9-/]+$/.test(c)) {
+            throw new Error(`Invalid component name: ${c}`);
+        }
+        return `${REGISTRY_BASE_URL}/${encodeURIComponent(c)}.json`;
+    });
+    const [command, dlxArgs] = dlxCommand(params.packageManager);
+    const args = [...dlxArgs, "shadcn@latest", "add", ...componentsToAdd];
+    // For npm, dlxArgs may already include `--yes` for npx auto-install.
+    // This flag is for shadcn's own confirmation prompt.
+    if (params.yes)
+        args.push("--yes");
+    if (params.overwrite)
+        args.push("--overwrite");
+    if (params.cwd)
+        args.push("--cwd", params.cwd);
+    if (params.path)
+        args.push("--path", params.path);
+    return { command, args };
+}
 export const add = new Command()
     .name("add")
     .description("add a component to your project")
@@ -11,44 +33,38 @@ export const add = new Command()
     .option("-o, --overwrite", "overwrite existing files.", false)
     .option("-c, --cwd <cwd>", "the working directory. defaults to the current directory.", process.cwd())
     .option("-p, --path <path>", "the path to add the component to.")
-    .action((components, opts) => {
+    .option("--use-npm", "explicitly use npm")
+    .option("--use-pnpm", "explicitly use pnpm")
+    .option("--use-yarn", "explicitly use yarn")
+    .option("--use-bun", "explicitly use bun")
+    .action(async (components, opts) => {
     // Check if project is initialized
     if (!hasConfig(opts.cwd)) {
         logger.warn("It looks like you haven't initialized your project yet. Run 'assistant-ui init' first.");
         logger.break();
     }
-    const componentsToAdd = components.map((c) => {
-        if (!/^[a-zA-Z0-9-/]+$/.test(c)) {
-            throw new Error(`Invalid component name: ${c}`);
-        }
-        return `${REGISTRY_BASE_URL}/${encodeURIComponent(c)}.json`;
-    });
     logger.step(`Adding ${components.length} component(s)...`);
-    const args = [`shadcn@latest`, "add", ...componentsToAdd];
-    if (opts.yes)
-        args.push("--yes");
-    if (opts.overwrite)
-        args.push("--overwrite");
-    if (opts.cwd)
-        args.push("--cwd", opts.cwd);
-    if (opts.path)
-        args.push("--path", opts.path);
-    const child = spawn("npx", args, {
-        stdio: "inherit",
-        shell: true,
-    });
-    child.on("error", (error) => {
-        logger.error(`Failed to add components: ${error.message}`);
-        process.exit(1);
+    const packageManager = await resolvePackageManagerForCwd(opts.cwd, resolvePackageManager(opts));
+    const { command, args } = createAddComponentsPlan({
+        components,
+        packageManager,
+        yes: opts.yes,
+        overwrite: opts.overwrite,
+        cwd: opts.cwd,
+        path: opts.path,
     });
-    child.on("close", (code) => {
-        if (code !== 0) {
-            logger.error(`Process exited with code ${code}`);
-            process.exit(code || 1);
-        }
-        else {
-            logger.success("Components added successfully!");
+    try {
+        await runSpawn(command, args, opts.cwd);
+    }
+    catch (error) {
+        if (error instanceof SpawnExitError) {
+            logger.error(`Process exited with code ${error.code}`);
+            process.exit(error.code);
         }
-    });
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error(`Failed to add components: ${message}`);
+        process.exit(1);
+    }
+    logger.success("Components added successfully!");
 });
 //# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

@@ -1 +1 @@
-{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"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"}

package/dist/commands/create.d.ts

@@ -1,6 +1,5 @@
 import { Command } from "commander";
 import * as p from "@clack/prompts";
-import { type PackageManagerName } from "../lib/create-project.js";
 export interface ProjectMetadata {
     name: string;
     label: string;
@@ -21,12 +20,19 @@ export declare function resolveCreateProjectDirectory(params: {
     projectDirectory?: string;
     stdinIsTTY?: boolean;
 }): string | undefined;
-export declare function resolvePackageManager(opts: {
-    useNpm?: boolean;
-    usePnpm?: boolean;
-    useYarn?: boolean;
-    useBun?: boolean;
-}): PackageManagerName | undefined;
 export declare function resolvePresetUrl(preset: string): string;
+export interface ScaffoldSelectorOptions {
+    template?: string;
+    example?: string;
+    preset?: string;
+    native?: boolean;
+    ink?: boolean;
+}
+export interface ResolvedScaffoldSelector {
+    template?: string;
+    example?: string;
+    preset?: string;
+}
+export declare function resolveScaffoldSelector(opts: ScaffoldSelectorOptions): ResolvedScaffoldSelector;
 export declare const create: Command;
 //# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAEpC,OAAO,EAML,KAAK,kBAAkB,EACxB,iCAA8B;AAE/B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,gBAAgB,EAAE,eAAe,EA2N7C,CAAC;AAmBF,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC;CAC9B,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAyElC;AAiCD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,GAAG,SAAS,CAMrB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,kBAAkB,GAAG,SAAS,CAMjC;AAKD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,eAAO,MAAM,MAAM,SAsOf,CAAC"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAapC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,gBAAgB,EAAE,eAAe,EA2N7C,CAAC;AAmBF,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC;CAC9B,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAyElC;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,GAAG,SAAS,CAMrB;AAKD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAYD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,uBAAuB,GAC5B,wBAAwB,CAkC1B;AAED,eAAO,MAAM,MAAM,SAmPf,CAAC"}

package/dist/commands/create.js

@@ -1,11 +1,11 @@
-import { Command } from "commander";
+import { Command, Option } from "commander";
 import chalk from "chalk";
-import { spawn } from "cross-spawn";
 import fs from "node:fs";
 import path from "node:path";
 import * as p from "@clack/prompts";
 import { logger } from "../lib/utils/logger.js";
-import { dlxCommand, downloadProject, resolveLatestReleaseRef, resolvePackageManagerName, transformProject, } from "../lib/create-project.js";
+import { dlxCommand, downloadProject, resolveLatestReleaseRef, resolvePackageManager, resolvePackageManagerForCwd, scaffoldProject, transformProject, } from "../lib/create-project.js";
+import { runSpawn, SpawnExitError } from "../lib/run-spawn.js";
 export const PROJECT_METADATA = [
     // Templates
     {
@@ -14,7 +14,7 @@ export const PROJECT_METADATA = [
         description: "Default template with Vercel AI SDK",
         category: "template",
         path: "templates/default",
-        hasLocalComponents: true,
+        hasLocalComponents: false,
     },
     {
         name: "minimal",
@@ -30,7 +30,7 @@ export const PROJECT_METADATA = [
         description: "Cloud-backed persistence starter",
         category: "template",
         path: "templates/cloud",
-        hasLocalComponents: true,
+        hasLocalComponents: false,
     },
     {
         name: "cloud-clerk",
@@ -38,7 +38,7 @@ export const PROJECT_METADATA = [
         description: "Cloud-backed starter with Clerk auth",
         category: "template",
         path: "templates/cloud-clerk",
-        hasLocalComponents: true,
+        hasLocalComponents: false,
     },
     {
         name: "langgraph",
@@ -46,15 +46,15 @@ export const PROJECT_METADATA = [
         description: "LangGraph starter template",
         category: "template",
         path: "templates/langgraph",
-        hasLocalComponents: true,
+        hasLocalComponents: false,
     },
     {
         name: "mcp",
         label: "MCP",
-        description: "MCP starter template",
+        description: "MCP tools + MCP Apps renderer starter",
         category: "template",
         path: "templates/mcp",
-        hasLocalComponents: true,
+        hasLocalComponents: false,
     },
     // Examples
     {
@@ -238,7 +238,7 @@ const templateNames = PROJECT_METADATA.filter((m) => m.category === "template").
 const exampleNames = PROJECT_METADATA.filter((m) => m.category === "example").map((m) => m.name);
 export async function resolveProject(params) {
     const { template, example, stdinIsTTY = process.stdin.isTTY, select = p.select, isCancel = p.isCancel, } = params;
-    if (template) {
+    if (template !== undefined) {
         const meta = PROJECT_METADATA.find((m) => m.name === template && m.category === "template");
         if (!meta) {
             logger.error(`Unknown template: ${template}`);
@@ -247,7 +247,7 @@ export async function resolveProject(params) {
         }
         return meta;
     }
-    if (example) {
+    if (example !== undefined) {
         const meta = PROJECT_METADATA.find((m) => m.name === example && m.category === "example");
         if (!meta) {
             logger.error(`Unknown example: ${example}`);
@@ -294,30 +294,6 @@ export async function resolveProject(params) {
     }
     return meta;
 }
-class SpawnExitError extends Error {
-    code;
-    constructor(code) {
-        super(`Process exited with code ${code}`);
-        this.code = code;
-    }
-}
-async function runSpawn(command, args, cwd) {
-    return new Promise((resolve, reject) => {
-        const child = spawn(command, args, {
-            stdio: "inherit",
-            cwd,
-        });
-        child.on("error", (error) => reject(error));
-        child.on("close", (code) => {
-            if (code !== 0) {
-                reject(new SpawnExitError(code || 1));
-            }
-            else {
-                resolve();
-            }
-        });
-    });
-}
 export function resolveCreateProjectDirectory(params) {
     const { projectDirectory, stdinIsTTY = process.stdin.isTTY } = params;
     if (projectDirectory)
@@ -326,17 +302,6 @@ export function resolveCreateProjectDirectory(params) {
         return "my-aui-app";
     return undefined;
 }
-export function resolvePackageManager(opts) {
-    if (opts.useNpm)
-        return "npm";
-    if (opts.usePnpm)
-        return "pnpm";
-    if (opts.useYarn)
-        return "yarn";
-    if (opts.useBun)
-        return "bun";
-    return undefined;
-}
 const PLAYGROUND_PRESET_BASE_URL = "https://www.assistant-ui.com/playground/init";
 export function resolvePresetUrl(preset) {
     if (preset.startsWith("http://") || preset.startsWith("https://")) {
@@ -344,6 +309,44 @@ export function resolvePresetUrl(preset) {
     }
     return `${PLAYGROUND_PRESET_BASE_URL}?preset=${encodeURIComponent(preset)}`;
 }
+const scaffoldSelectorHelp = "Choose one scaffold selector: --template <name>, --example <name>, --native, or --ink. --preset <name-or-url> can be used with --template or by itself.";
+function getPresetConflict(opts) {
+    if (opts.example !== undefined)
+        return "--example";
+    if (opts.native)
+        return "--native";
+    if (opts.ink)
+        return "--ink";
+    return undefined;
+}
+export function resolveScaffoldSelector(opts) {
+    const hasPreset = opts.preset !== undefined;
+    const presetConflict = getPresetConflict(opts);
+    const selectors = [
+        opts.template !== undefined ? "--template" : undefined,
+        opts.example !== undefined ? "--example" : undefined,
+        opts.native ? "--native" : undefined,
+        opts.ink ? "--ink" : undefined,
+    ].filter((selector) => selector !== undefined);
+    if (selectors.length > 1) {
+        throw new Error(`Only one scaffold selector can be provided (${selectors.join(", ")}). ${scaffoldSelectorHelp}`);
+    }
+    if (hasPreset && presetConflict) {
+        throw new Error(`Cannot use --preset with ${presetConflict}. ${scaffoldSelectorHelp}`);
+    }
+    if (opts.native)
+        return { example: "with-expo" };
+    if (opts.ink)
+        return { example: "with-react-ink" };
+    if (opts.preset !== undefined && opts.template === undefined) {
+        return { template: "default", preset: opts.preset };
+    }
+    return {
+        ...(opts.template !== undefined && { template: opts.template }),
+        ...(opts.example !== undefined && { example: opts.example }),
+        ...(hasPreset && { preset: opts.preset }),
+    };
+}
 export const create = new Command()
     .name("create")
     .description("create a new project")
@@ -359,23 +362,24 @@ export const create = new Command()
     .option("--native", "create an Expo / React Native project")
     .option("--ink", "create a React Ink terminal project")
     .option("--skip-install", "skip installing packages")
+    .addOption(new Option("--debug-source-root <path>", "copy templates/examples from a local assistant-ui repo root").hideHelp())
     .action(async (projectDirectory, opts) => {
-    if (opts.native) {
-        opts.example = "with-expo";
-    }
-    if (opts.ink) {
-        opts.example = "with-react-ink";
-    }
-    if (opts.example && opts.preset) {
-        logger.error("Cannot use --preset with --example.");
-        process.exit(1);
+    let scaffoldSelector;
+    try {
+        scaffoldSelector = resolveScaffoldSelector(opts);
     }
-    if (opts.template && opts.example) {
-        logger.error("Cannot use both --template and --example.");
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error(message);
         process.exit(1);
     }
+    const localSourceRoot = opts.debugSourceRoot
+        ? path.resolve(opts.debugSourceRoot)
+        : undefined;
     // Start release ref resolution early (runs during user prompts)
-    const refPromise = resolveLatestReleaseRef();
+    const refPromise = localSourceRoot
+        ? Promise.resolve(undefined)
+        : resolveLatestReleaseRef();
     // 1. Resolve project directory
     let resolvedProjectDirectory = resolveCreateProjectDirectory({
         projectDirectory,
@@ -427,17 +431,14 @@ export const create = new Command()
         }
     }
     // 2. Resolve scaffold target
-    const project = await resolveProject({
-        template: opts.template,
-        example: opts.example,
-    });
+    const project = await resolveProject(scaffoldSelector);
     if (!project) {
         p.cancel("Project creation cancelled.");
         process.exit(0);
     }
     logger.info(`Creating project from ${project.category}: ${project.label}`);
     logger.break();
-    const pm = await resolvePackageManagerName(absoluteProjectDir, resolvePackageManager(opts));
+    const pm = await resolvePackageManagerForCwd(path.dirname(absoluteProjectDir), resolvePackageManager(opts));
     // Clean up partial project directory on unexpected exit (e.g. Ctrl+C)
     const cleanupOnExit = () => {
         fs.rmSync(absoluteProjectDir, { recursive: true, force: true });
@@ -445,17 +446,28 @@ export const create = new Command()
     process.once("exit", cleanupOnExit);
     try {
         // 3. Resolve latest release ref (started before prompts)
-        logger.step("Resolving latest release...");
+        if (!localSourceRoot) {
+            logger.step("Resolving latest release...");
+        }
         const ref = await refPromise;
-        if (!ref) {
+        if (!localSourceRoot && !ref) {
             logger.warn("Could not resolve latest release, downloading from HEAD");
         }
-        // 4. Download project
-        logger.step("Downloading project...");
+        // 4. Scaffold project
+        logger.step(localSourceRoot
+            ? `Copying project from local source: ${localSourceRoot}`
+            : "Downloading project...");
         try {
-            await downloadProject(project.path, absoluteProjectDir, ref);
+            const source = localSourceRoot
+                ? { kind: "local", rootDir: localSourceRoot }
+                : {
+                    kind: "github",
+                    ref,
+                };
+            await scaffoldProject(project.path, absoluteProjectDir, source);
             // If the template didn't exist at the release tag, retry from HEAD
-            if (ref &&
+            if (!localSourceRoot &&
+                ref &&
                 !fs.existsSync(path.join(absoluteProjectDir, "package.json"))) {
                 fs.rmSync(absoluteProjectDir, { recursive: true, force: true });
                 logger.warn("Template not found at release tag, downloading from HEAD");
@@ -474,8 +486,8 @@ export const create = new Command()
             throw err;
         }
         // 6. Apply preset if provided
-        if (opts.preset) {
-            const presetUrl = resolvePresetUrl(opts.preset);
+        if (scaffoldSelector.preset) {
+            const presetUrl = resolvePresetUrl(scaffoldSelector.preset);
             logger.info("Applying preset configuration...");
             logger.break();
             const [dlxCmd, dlxArgs] = dlxCommand(pm);