assistant-ui 0.0.81 → 0.0.83

package/dist/index.js

@@ -6,6 +6,7 @@ import { codemodCommand, upgradeCommand } from "./commands/upgrade.js";
 import { init } from "./commands/init.js";
 import { update } from "./commands/update.js";
 import { mcp } from "./commands/mcp.js";
+import { agent } from "./commands/agent.js";
 process.on("SIGINT", () => process.exit(0));
 process.on("SIGTERM", () => process.exit(0));
 function main() {
@@ -19,6 +20,7 @@ function main() {
     program.addCommand(codemodCommand);
     program.addCommand(upgradeCommand);
     program.addCommand(update);
+    program.addCommand(agent);
     program.parse();
 }
 main();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,6BAA0B;AAC3C,OAAO,EAAE,GAAG,EAAE,0BAAuB;AACrC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,8BAA2B;AACpE,OAAO,EAAE,IAAI,EAAE,2BAAwB;AACvC,OAAO,EAAE,MAAM,EAAE,6BAA0B;AAC3C,OAAO,EAAE,GAAG,EAAE,0BAAuB;AAErC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7C,SAAS,IAAI;IACX,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,cAAc,CAAC;SACpB,WAAW,CAAC,iDAAiD,CAAC,CAAC;IAElE,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAE3B,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,6BAA0B;AAC3C,OAAO,EAAE,GAAG,EAAE,0BAAuB;AACrC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,8BAA2B;AACpE,OAAO,EAAE,IAAI,EAAE,2BAAwB;AACvC,OAAO,EAAE,MAAM,EAAE,6BAA0B;AAC3C,OAAO,EAAE,GAAG,EAAE,0BAAuB;AACrC,OAAO,EAAE,KAAK,EAAE,4BAAyB;AAEzC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7C,SAAS,IAAI;IACX,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,cAAc,CAAC;SACpB,WAAW,CAAC,iDAAiD,CAAC,CAAC;IAElE,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAE1B,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/lib/create-project.d.ts

@@ -0,0 +1,12 @@
+export type PackageManagerName = "npm" | "pnpm" | "yarn" | "bun";
+export declare function dlxCommand(pm: PackageManagerName): [string, string[]];
+export interface TransformOptions {
+    hasLocalComponents: boolean;
+    skipInstall?: boolean;
+    packageManager?: PackageManagerName;
+}
+export declare function resolveLatestReleaseRef(): Promise<string | undefined>;
+export declare function downloadProject(repoPath: string, destDir: string, ref?: string): Promise<void>;
+export declare function resolvePackageManagerName(projectDir: string, packageManager?: PackageManagerName): Promise<PackageManagerName>;
+export declare function transformProject(projectDir: string, opts: TransformOptions): Promise<void>;
+//# sourceMappingURL=create-project.d.ts.map

package/dist/lib/create-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-project.d.ts","sourceRoot":"","sources":["../../src/lib/create-project.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEjE,wBAAgB,UAAU,CAAC,EAAE,EAAE,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAWrE;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW3E;AAID,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,kBAAkB,GAClC,OAAO,CAAC,kBAAkB,CAAC,CAO7B;AAED,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAgDf"}

package/dist/lib/create-project.js

@@ -0,0 +1,273 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { downloadTemplate } from "giget";
+import { spawn } from "cross-spawn";
+import { sync as globSync } from "glob";
+import { detect } from "detect-package-manager";
+import { logger } from "./utils/logger.js";
+export function dlxCommand(pm) {
+    switch (pm) {
+        case "pnpm":
+            return ["pnpm", ["dlx"]];
+        case "yarn":
+            return ["yarn", ["dlx"]];
+        case "bun":
+            return ["bunx", []];
+        case "npm":
+            return ["npx", ["--yes"]];
+    }
+}
+export async function resolveLatestReleaseRef() {
+    try {
+        const res = await fetch("https://api.github.com/repos/assistant-ui/assistant-ui/releases/latest");
+        if (!res.ok)
+            return undefined;
+        const release = (await res.json());
+        return release.tag_name || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+const DOWNLOAD_TIMEOUT_MS = 30_000;
+export async function downloadProject(repoPath, destDir, ref) {
+    const source = ref
+        ? `gh:assistant-ui/assistant-ui/${repoPath}#${ref}`
+        : `gh:assistant-ui/assistant-ui/${repoPath}`;
+    // Suppress giget's console.debug output
+    const origDebug = console.debug;
+    console.debug = () => { };
+    try {
+        const downloadPromise = downloadTemplate(source, {
+            dir: destDir,
+            force: true,
+            silent: true,
+        });
+        let timer;
+        const timeoutPromise = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error("Download timed out. This may be due to GitHub rate limiting or a network issue. Try again in a few minutes.")), DOWNLOAD_TIMEOUT_MS);
+        });
+        try {
+            await Promise.race([downloadPromise, timeoutPromise]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    finally {
+        console.debug = origDebug;
+    }
+}
+export async function resolvePackageManagerName(projectDir, packageManager) {
+    if (packageManager)
+        return packageManager;
+    try {
+        return await detect({ cwd: path.dirname(projectDir) });
+    }
+    catch {
+        return "npm";
+    }
+}
+export async function transformProject(projectDir, opts) {
+    // 1. Transform package.json (always)
+    logger.step("Transforming package.json...");
+    await transformPackageJson(projectDir);
+    let assistantUI;
+    let shadcnUI;
+    if (!opts.hasLocalComponents) {
+        logger.step("Transforming project files...");
+        // 2–5. Transform tsconfig, CSS, scan components, and remove workspace
+        // components — all independent, run in parallel
+        const [, , components] = await Promise.all([
+            transformTsConfig(projectDir),
+            transformCssFiles(projectDir),
+            scanRequiredComponents(projectDir),
+            removeWorkspaceComponents(projectDir),
+        ]);
+        assistantUI = components.assistantUI;
+        shadcnUI = components.shadcnUI;
+    }
+    // 6. Install dependencies
+    const pm = opts.packageManager ?? (await resolvePackageManagerName(projectDir));
+    if (!opts.skipInstall) {
+        logger.step("Installing dependencies...");
+        await installDependencies(projectDir, pm);
+    }
+    if (!opts.hasLocalComponents && shadcnUI && assistantUI) {
+        // 7. Install shadcn UI components
+        const allShadcn = shadcnUI.includes("utils")
+            ? shadcnUI
+            : [...shadcnUI, "utils"];
+        logger.step(`Installing shadcn UI components: ${allShadcn.join(", ")}...`);
+        await installShadcnRegistry(projectDir, allShadcn, "shadcn components", pm);
+        // 8. Install assistant-ui components
+        if (assistantUI.length > 0) {
+            const auiComponents = assistantUI.map((c) => `@assistant-ui/${c}`);
+            logger.step(`Installing assistant-ui components: ${assistantUI.join(", ")}...`);
+            await installShadcnRegistry(projectDir, auiComponents, "components", pm);
+        }
+    }
+}
+async function transformPackageJson(projectDir) {
+    const pkgPath = path.join(projectDir, "package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    // Remove @assistant-ui/ui (workspace-only package)
+    if (pkg.dependencies?.["@assistant-ui/ui"]) {
+        delete pkg.dependencies["@assistant-ui/ui"];
+    }
+    // Transform workspace dependencies to latest
+    for (const depType of ["dependencies", "devDependencies"]) {
+        const deps = pkg[depType];
+        if (!deps)
+            continue;
+        for (const [name, version] of Object.entries(deps)) {
+            if (String(version).includes("workspace:")) {
+                deps[name] = "latest";
+            }
+        }
+    }
+    // Remove devDependencies that are workspace-only
+    if (pkg.devDependencies?.["@assistant-ui/x-buildutils"]) {
+        delete pkg.devDependencies["@assistant-ui/x-buildutils"];
+    }
+    // Update package name to be unique
+    const dirName = path.basename(projectDir);
+    pkg.name = dirName;
+    fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
+}
+async function transformTsConfig(projectDir) {
+    const tsconfigPath = path.join(projectDir, "tsconfig.json");
+    if (!fs.existsSync(tsconfigPath)) {
+        return;
+    }
+    const content = fs.readFileSync(tsconfigPath, "utf-8");
+    const tsconfig = JSON.parse(content);
+    // Remove workspace paths
+    if (tsconfig.compilerOptions?.paths) {
+        delete tsconfig.compilerOptions.paths["@/components/assistant-ui/*"];
+        delete tsconfig.compilerOptions.paths["@/components/ui/*"];
+        delete tsconfig.compilerOptions.paths["@/lib/utils"];
+        delete tsconfig.compilerOptions.paths["@assistant-ui/ui/*"];
+        if (Object.keys(tsconfig.compilerOptions.paths).length === 0) {
+            delete tsconfig.compilerOptions.paths;
+        }
+    }
+    // If extends uses @assistant-ui/x-buildutils, replace with inline config
+    if (tsconfig.extends?.includes("@assistant-ui/x-buildutils")) {
+        const isNext = tsconfig.extends.includes("ts/next");
+        delete tsconfig.extends;
+        const inlinedCompilerOptions = {
+            target: "ESNext",
+            lib: ["dom", "dom.iterable", "ES2023"],
+            skipLibCheck: true,
+            strict: true,
+            noEmit: true,
+            esModuleInterop: true,
+            module: "ESNext",
+            moduleResolution: "bundler",
+            resolveJsonModule: true,
+            isolatedModules: true,
+            jsx: "react-jsx",
+            ...(isNext ? { plugins: [{ name: "next" }] } : {}),
+        };
+        tsconfig.compilerOptions = {
+            ...inlinedCompilerOptions,
+            ...tsconfig.compilerOptions,
+            paths: {
+                "@/*": ["./*"],
+                ...(tsconfig.compilerOptions?.paths || {}),
+            },
+        };
+    }
+    fs.writeFileSync(tsconfigPath, `${JSON.stringify(tsconfig, null, 2)}\n`);
+}
+async function transformCssFiles(projectDir) {
+    const cssFiles = globSync("**/*.css", {
+        cwd: projectDir,
+        ignore: ["**/node_modules/**", "**/dist/**", "**/.next/**"],
+    });
+    for (const file of cssFiles) {
+        const fullPath = path.join(projectDir, file);
+        try {
+            let content = fs.readFileSync(fullPath, "utf-8");
+            content = content.replace(/@source\s+["'][^"']*packages\/ui\/src[^"']*["'];\s*\n?/g, "");
+            fs.writeFileSync(fullPath, content);
+        }
+        catch {
+            // Ignore files that cannot be read/written
+        }
+    }
+}
+async function scanRequiredComponents(projectDir) {
+    const files = globSync("**/*.{ts,tsx}", {
+        cwd: projectDir,
+        ignore: ["**/node_modules/**", "**/dist/**", "**/.next/**"],
+    });
+    const assistantUIComponents = new Set();
+    const shadcnUIComponents = new Set();
+    for (const file of files) {
+        const fullPath = path.join(projectDir, file);
+        try {
+            const content = fs.readFileSync(fullPath, "utf-8");
+            const assistantUIRegex = /from\s+["']@\/components\/assistant-ui\/([^"']+)["']/g;
+            let match;
+            while ((match = assistantUIRegex.exec(content)) !== null) {
+                assistantUIComponents.add(match[1]);
+            }
+            const uiRegex = /from\s+["']@\/components\/ui\/([^"']+)["']/g;
+            while ((match = uiRegex.exec(content)) !== null) {
+                shadcnUIComponents.add(match[1]);
+            }
+        }
+        catch {
+            // Ignore files that cannot be read
+        }
+    }
+    return {
+        assistantUI: Array.from(assistantUIComponents),
+        shadcnUI: Array.from(shadcnUIComponents),
+    };
+}
+async function removeWorkspaceComponents(projectDir) {
+    const componentsDir = path.join(projectDir, "components", "assistant-ui");
+    fs.rmSync(componentsDir, { recursive: true, force: true });
+}
+async function installDependencies(projectDir, pm) {
+    const args = pm === "yarn" ? [] : ["install"];
+    return new Promise((resolve, reject) => {
+        const child = spawn(pm, args, {
+            cwd: projectDir,
+            stdio: "inherit",
+        });
+        child.on("error", (error) => {
+            reject(new Error(`Failed to install dependencies: ${error.message}`));
+        });
+        child.on("close", (code) => {
+            if (code !== 0) {
+                reject(new Error(`${pm} install exited with code ${code}`));
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+async function installShadcnRegistry(projectDir, components, label, pm) {
+    const [cmd, dlxArgs] = dlxCommand(pm);
+    return new Promise((resolve, reject) => {
+        const child = spawn(cmd, [...dlxArgs, "shadcn@latest", "add", ...components, "--yes"], {
+            cwd: projectDir,
+            stdio: "inherit",
+        });
+        child.on("error", (error) => {
+            reject(new Error(`Failed to install ${label}: ${error.message}`));
+        });
+        child.on("close", (code) => {
+            if (code !== 0) {
+                logger.warn(`shadcn exited with code ${code}. Run the following to retry:\n  ${cmd} ${[...dlxArgs, "shadcn@latest", "add", ...components].join(" ")}`);
+            }
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=create-project.js.map

package/dist/lib/create-project.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assistant-ui",
-  "version": "0.0.81",
+  "version": "0.0.83",
   "description": "CLI for assistant-ui",
   "keywords": [
     "cli",
@@ -15,10 +15,12 @@
   "license": "MIT",
   "type": "module",
   "bin": {
-    "assistant-ui": "./dist/index.js"
+    "assistant-ui": "./bin/assistant-ui.js"
   },
   "files": [
+    "bin",
     "dist",
+    "plugin",
     "src",
     "README.md"
   ],
@@ -31,8 +33,10 @@
     "cross-spawn": "^7.0.6",
     "debug": "^4.4.3",
     "detect-package-manager": "^3.0.2",
+    "giget": "^3.1.2",
     "glob": "^13.0.6",
-    "jscodeshift": "^17.3.0"
+    "jscodeshift": "^17.3.0",
+    "@assistant-ui/agent-launcher": "0.1.0"
   },
   "devDependencies": {
     "@types/cli-progress": "^3.11.6",
@@ -42,7 +46,7 @@
     "@types/node": "^25.3.3",
     "@vitest/coverage-v8": "^4.0.18",
     "vitest": "^4.0.18",
-    "@assistant-ui/x-buildutils": "0.0.1"
+    "@assistant-ui/x-buildutils": "0.0.2"
   },
   "publishConfig": {
     "access": "public",

package/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "assistant-ui",
+  "description": "Build AI chat interfaces using assistant-ui components",
+  "version": "0.1.0",
+  "author": {
+    "name": "assistant-ui"
+  }
+}

package/plugin/skills/assistant-ui/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: assistant-ui
+description: Add, configure, and integrate assistant-ui components in React apps. Use when developers ask to add a chat thread, set up a runtime, integrate with AI SDK, configure tools, or build AI chat interfaces with assistant-ui.
+---
+
+# assistant-ui
+
+Use this skill to help users build AI chat interfaces with assistant-ui.
+
+## Step 1: Check Project Setup
+
+Check if the project has `components.json` (shadcn config) and `@assistant-ui/react` installed.
+
+If assistant-ui is not yet set up, run:
+
+```bash
+npx assistant-ui init --yes
+```
+
+This initializes shadcn and installs the default assistant-ui chat components.
+
+## Step 2: Add Components
+
+Install components via the shadcn registry:
+
+```bash
+npx shadcn@latest add "https://r.assistant-ui.com/chat/b/ai-sdk-quick-start/json"
+```
+
+Available component presets:
+
+| Preset | Registry URL |
+|--------|-------------|
+| AI SDK Quick Start | `https://r.assistant-ui.com/chat/b/ai-sdk-quick-start/json` |
+
+You can also add individual assistant-ui shadcn components:
+
+```bash
+npx shadcn@latest add assistant-ui/thread
+npx shadcn@latest add assistant-ui/markdown-text
+```
+
+## Step 3: Runtime Setup
+
+assistant-ui requires a runtime. The most common setup uses AI SDK:
+
+### AI SDK Runtime (recommended)
+
+Install the integration package:
+```bash
+npm install @assistant-ui/react-ai-sdk
+```
+
+Create a chat API route (Next.js App Router):
+
+```ts
+// app/api/chat/route.ts
+import { openai } from "@ai-sdk/openai";
+import { streamText } from "ai";
+
+export const maxDuration = 30;
+
+export async function POST(req: Request) {
+  const { messages, config } = await req.json();
+
+  const result = streamText({
+    model: openai("gpt-4o"),
+    messages,
+    ...config,
+  });
+
+  return result.toDataStreamResponse();
+}
+```
+
+Create the assistant component:
+
+```tsx
+"use client";
+
+import { AssistantRuntimeProvider } from "@assistant-ui/react";
+import { useChatRuntime } from "@assistant-ui/react-ai-sdk";
+import { Thread } from "@/components/assistant-ui/thread";
+
+export const Assistant = () => {
+  const runtime = useChatRuntime({
+    api: "/api/chat",
+  });
+
+  return (
+    <AssistantRuntimeProvider runtime={runtime}>
+      <Thread />
+    </AssistantRuntimeProvider>
+  );
+};
+```
+
+## Step 4: Tools (optional)
+
+To add tool calling support, define tools on the backend and render them on the frontend:
+
+### Backend tool (AI SDK):
+
+```ts
+import { streamText, tool } from "ai";
+import { z } from "zod";
+
+const result = streamText({
+  model: openai("gpt-4o"),
+  messages,
+  tools: {
+    get_weather: tool({
+      description: "Get weather for a location",
+      parameters: z.object({
+        location: z.string(),
+      }),
+      execute: async ({ location }) => {
+        return { temperature: 72, condition: "sunny", location };
+      },
+    }),
+  },
+});
+```
+
+### Frontend tool UI:
+
+```tsx
+"use client";
+
+import { makeAssistantToolUI } from "@assistant-ui/react";
+
+export const WeatherToolUI = makeAssistantToolUI({
+  toolName: "get_weather",
+  render: ({ args, result }) => {
+    return (
+      <div>
+        <p>Weather for {args?.location}</p>
+        {result && <p>{result.temperature}F, {result.condition}</p>}
+      </div>
+    );
+  },
+});
+```
+
+Register the tool UI in your assistant component:
+
+```tsx
+<AssistantRuntimeProvider runtime={runtime}>
+  <WeatherToolUI />
+  <Thread />
+</AssistantRuntimeProvider>
+```
+
+## Key Packages
+
+| Package | Purpose |
+|---------|---------|
+| `@assistant-ui/react` | Core React components and primitives |
+| `@assistant-ui/react-ai-sdk` | Vercel AI SDK integration |
+| `@assistant-ui/react-markdown` | Markdown rendering |
+| `@assistant-ui/react-syntax-highlighter` | Code highlighting |
+| `@assistant-ui/ui` | Pre-built shadcn/ui component set |
+| `@assistant-ui/styles` | Pre-built CSS for non-Tailwind users |
+
+## Environment Variables
+
+For OpenAI-based setups, ensure `OPENAI_API_KEY` is set in `.env.local`.

package/src/commands/agent.ts

@@ -0,0 +1,36 @@
+import { Command } from "commander";
+import { resolve, dirname } from "node:path";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { launch } from "@assistant-ui/agent-launcher";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+function getPluginPath(): string {
+  // In dist/, plugin is at ../../plugin relative to dist/commands/agent.js
+  // In dev (src/), plugin is at ../../plugin relative to src/commands/
+  const candidates = [
+    resolve(__dirname, "..", "..", "plugin"),
+    resolve(__dirname, "..", "plugin"),
+  ];
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) return candidate;
+  }
+  return candidates[0]!;
+}
+
+export const agent = new Command()
+  .name("agent")
+  .description("launch Claude Code with assistant-ui skills")
+  .argument("<prompt...>", "prompt for the agent")
+  .option("--dry", "print the command instead of running it")
+  .action((promptParts: string[], opts) => {
+    const prompt = promptParts.join(" ");
+
+    launch({
+      pluginDir: getPluginPath(),
+      skillName: "assistant-ui",
+      prompt,
+      dry: opts.dry,
+    });
+  });