Skip to content

The Open Standard for Generative UI

Move CLI templates to the repo root (#1113)

ABcfeaee006e84
diff --git a/.github/workflows/cli-e2e.yml b/.github/workflows/cli-e2e.yml
index f1413c4f7..e8640336f 100644
--- a/.github/workflows/cli-e2e.yml
+++ b/.github/workflows/cli-e2e.yml
@@ -6,12 +6,14 @@ on:
paths:
- ".github/workflows/cli-e2e.yml"
- "packages/openui-cli/**"
+ - "templates/**"
- "tsconfig.json"
pull_request:
branches: [main]
paths:
- ".github/workflows/cli-e2e.yml"
- "packages/openui-cli/**"
+ - "templates/**"
- "tsconfig.json"
permissions:
@@ -35,7 +37,7 @@ jobs:
- name: Install workspace dependencies
run: pnpm install --frozen-lockfile
- - name: Build CLI and templates
+ - name: Build CLI
run: pnpm --filter @openuidev/cli build
- name: Pack CLI
@@ -146,6 +148,8 @@ jobs:
package-manager-version: "11"
steps:
+ - uses: actions/checkout@v6
+
- uses: actions/setup-node@v6
with:
node-version: ${{ matrix.node-version }}
diff --git a/.github/workflows/cli-template-package-managers.yml b/.github/workflows/cli-template-package-managers.yml
index cc99820c8..eca48af6a 100644
--- a/.github/workflows/cli-template-package-managers.yml
+++ b/.github/workflows/cli-template-package-managers.yml
@@ -8,7 +8,7 @@ on:
- "packages/openui-cli/scripts/compare-template-installs.mjs"
- "packages/openui-cli/src/commands/create-app.ts"
- "packages/openui-cli/src/lib/detect-package-manager.ts"
- - "packages/openui-cli/src/templates/**"
+ - "templates/**"
pull_request:
branches: [main]
paths:
@@ -16,7 +16,7 @@ on:
- "packages/openui-cli/scripts/compare-template-installs.mjs"
- "packages/openui-cli/src/commands/create-app.ts"
- "packages/openui-cli/src/lib/detect-package-manager.ts"
- - "packages/openui-cli/src/templates/**"
+ - "templates/**"
permissions:
contents: read
@@ -49,7 +49,7 @@ jobs:
node --input-type=module -e "
import fs from 'node:fs';
import path from 'node:path';
- const source = path.resolve('packages/openui-cli/src/templates/${{ matrix.template }}');
+ const source = path.resolve('templates/${{ matrix.template }}');
const npmTarget = path.join(process.env.RUNNER_TEMP, 'npm-template');
const pnpmTarget = path.join(process.env.RUNNER_TEMP, 'pnpm-template');
fs.cpSync(source, npmTarget, { recursive: true });
diff --git a/docs/content/docs/openui-cloud/api/conversations.mdx b/docs/content/docs/openui-cloud/api/conversations.mdx
index ca11c1465..442ff7cf3 100644
--- a/docs/content/docs/openui-cloud/api/conversations.mdx
+++ b/docs/content/docs/openui-cloud/api/conversations.mdx
@@ -90,4 +90,4 @@ export function Chat() {
The `/api/frontend-token` server route mints a short-lived token with `POST /v1/frontend-tokens`, binding it to your authenticated `user_id` and optional `app_id`. The browser sends that token as `x-thesys-frontend-token`; the server API key never leaves your backend.
-Use the current [frontend-token route](https://github.com/thesysdev/openui/blob/main/packages/openui-cli/src/templates/openui-cloud/src/app/api/frontend-token/route.ts) and [Cloud storage setup](https://github.com/thesysdev/openui/blob/main/packages/openui-cli/src/templates/openui-cloud/src/components/cloud-chat.tsx) as complete references.
+Use the current [frontend-token route](https://github.com/thesysdev/openui/blob/main/templates/openui-cloud/src/app/api/frontend-token/route.ts) and [Cloud storage setup](https://github.com/thesysdev/openui/blob/main/templates/openui-cloud/src/components/cloud-chat.tsx) as complete references.
diff --git a/docs/content/docs/openui-cloud/api/responses.mdx b/docs/content/docs/openui-cloud/api/responses.mdx
index 6cfa9025b..98d898c72 100644
--- a/docs/content/docs/openui-cloud/api/responses.mdx
+++ b/docs/content/docs/openui-cloud/api/responses.mdx
@@ -143,6 +143,6 @@ const response = await embedClient.responses.create({
});
```
-Artifacts are stored separately from chat messages. Register `presentationArtifactRenderer`, `reportArtifactRenderer`, and `useOpenuiCloudStorage()` with `AgentInterface` to render and persist them. The [OpenUI Cloud scaffold](https://github.com/thesysdev/openui/blob/main/packages/openui-cli/src/templates/openui-cloud/src/components/cloud-chat.tsx) contains the complete client setup.
+Artifacts are stored separately from chat messages. Register `presentationArtifactRenderer`, `reportArtifactRenderer`, and `useOpenuiCloudStorage()` with `AgentInterface` to render and persist them. The [OpenUI Cloud scaffold](https://github.com/thesysdev/openui/blob/main/templates/openui-cloud/src/components/cloud-chat.tsx) contains the complete client setup.
Follow-up requests in the same stored conversation edit the existing artifact automatically. Use [Chat Completions for artifacts](/docs/openui-cloud/api/artifacts) when you need standalone generation or explicitly managed edits outside an agent stream.
diff --git a/eslint.config.cjs b/eslint.config.cjs
index 83e2a238a..b28f2f40d 100644
--- a/eslint.config.cjs
+++ b/eslint.config.cjs
@@ -8,7 +8,7 @@ const reactHooks = require("eslint-plugin-react-hooks");
module.exports = [
{
- ignores: ["**/src/templates/**", "**/.storybook/**"],
+ ignores: ["templates/**", "**/.storybook/**"],
},
{
files: ["**/__tests__/**/*.{ts,tsx}", "**/*.test.{ts,tsx}", "**/*.spec.{ts,tsx}"],
diff --git a/packages/openui-cli/README.md b/packages/openui-cli/README.md
index 267818c5f..2868338d8 100644
--- a/packages/openui-cli/README.md
+++ b/packages/openui-cli/README.md
@@ -110,6 +110,8 @@ What it does:
#### Backend frameworks
+Overlay names are loaded from the fetched template's `overlays/` directory (`default` is the base template with no overlay). Current templates ship:
+
| Value | OpenUI Cloud route | Self-hosted route |
| --------------- | -------------------------------------------- | ---------------------------------------- |
| `default` | Direct OpenAI SDK Responses proxy | Direct OpenAI SDK Chat Completions proxy |
@@ -256,7 +258,7 @@ openui create --no-telemetry
## Notes
- interactive prompts can be cancelled without creating output
-- `create` requires the selected template's files to be present in the built package
+- `create` fetches `templates/templates.json` and the selected template from GitHub (`thesysdev/openui@main`)
- `generate` exits with a non-zero code if the file is missing or no valid library export is found
## Documentation
diff --git a/packages/openui-cli/package.json b/packages/openui-cli/package.json
index b43dfa3d5..c9c03ede1 100644
--- a/packages/openui-cli/package.json
+++ b/packages/openui-cli/package.json
@@ -11,20 +11,18 @@
],
"scripts": {
"build:cli": "tsc -p .",
- "build:templates": "node scripts/build-templates.js",
- "build": "pnpm run build:cli && pnpm run build:templates",
+ "build": "pnpm run build:cli",
"build:exec": "node dist/index.js",
- "lint:check": "eslint ./src --ignore-pattern 'src/templates/**'",
- "lint:fix": "eslint ./src --fix --ignore-pattern 'src/templates/**'",
- "format:fix": "prettier --write './src/**' '!./src/templates/**'",
- "format:check": "prettier --check './src/**' '!./src/templates/**'",
+ "lint:check": "eslint ./src",
+ "lint:fix": "eslint ./src --fix",
+ "format:fix": "prettier --write './src/**'",
+ "format:check": "prettier --check './src/**'",
"prepare": "pnpm run build",
"ci": "pnpm run lint:check && pnpm run format:check"
},
"devDependencies": {
"@types/cross-spawn": "^6.0.6",
- "@types/node": "catalog:",
- "rimraf": "^5.0.7"
+ "@types/node": "catalog:"
},
"keywords": [
"openui",
diff --git a/packages/openui-cli/scripts/build-templates.js b/packages/openui-cli/scripts/build-templates.js
deleted file mode 100644
index 1978d3c7c..000000000
--- a/packages/openui-cli/scripts/build-templates.js
+++ /dev/null
@@ -1,23 +0,0 @@
-const fs = require("node:fs");
-const path = require("node:path");
-const { rimrafSync } = require("rimraf");
-
-const TEMPLATES = ["openui-self-hosted", "openui-cloud"];
-
-for (const template of TEMPLATES) {
- const srcDir = path.resolve(__dirname, "../src/templates", template);
- const destDir = path.resolve(__dirname, "../dist/templates", template);
-
- if (!fs.existsSync(srcDir)) {
- throw new Error(`Template source directory not found: ${srcDir}`);
- }
-
- // Equivalent to: rm -rf dist/templates/<template>
- fs.rmSync(destDir, { recursive: true, force: true });
-
- // Equivalent to: mkdir -p dist/templates
- fs.mkdirSync(path.dirname(destDir), { recursive: true });
-
- // Equivalent to: cp -R src/templates/<template> dist/templates/<template>
- fs.cpSync(srcDir, destDir, { recursive: true });
-}
diff --git a/packages/openui-cli/src/commands/create-app.ts b/packages/openui-cli/src/commands/create-app.ts
index d02730af4..1e1a027e2 100644
--- a/packages/openui-cli/src/commands/create-app.ts
+++ b/packages/openui-cli/src/commands/create-app.ts
@@ -12,12 +12,25 @@ import {
} from "../lib/detect-package-manager";
import { runDevCommand } from "../lib/dev-server";
import { runSkillInstall, shouldInstallSkill } from "../lib/install-skill";
-import { applyOverlay, OVERLAYS_DIR, resolveOverlay, type OverlayManifest } from "../lib/overlays";
+import {
+ applyOverlay,
+ OVERLAYS_DIR,
+ resolveOverlay,
+ type OverlayManifest,
+ type TemplateOverlay,
+} from "../lib/overlays";
import { runCommand } from "../lib/process-runner";
import { resolveArgs } from "../lib/resolve-args";
+import { resolveTemplateSource } from "../lib/scaffold-template";
import { withSpinner } from "../lib/spinner";
import { resolveAvailableTarget } from "../lib/target-dir";
import { CliCancelledError, CreateError, telemetry } from "../lib/telemetry";
+import {
+ DEFAULT_TEMPLATE_KEY,
+ findCatalogOverlay,
+ findCatalogTemplate,
+ loadTemplatesCatalog,
+} from "../lib/templates-catalog";
import { cliErrorProperties, processErrorProperties } from "../lib/utils";
function shouldCopyTemplatePath(templateDir: string, src: string): boolean {
@@ -157,7 +170,24 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {
immediate_arg: options.immediate,
});
- // Resolved on its own, and validated before anything else is asked
+ // Interactive runs always scaffold the Cloud backend; openui-self-hosted stays
+ // available, but only when requested explicitly with --template.
+ if (!options.template && !interactive) {
+ throw new CreateError(
+ "args_resolution",
+ "Missing required argument --template",
+ "invalid_input",
+ "MISSING_REQUIRED_ARG",
+ );
+ }
+
+ const catalog = await loadTemplatesCatalog();
+ const template: TemplateName = options.template ?? DEFAULT_TEMPLATE_KEY;
+ const templateEntry = findCatalogTemplate(catalog, template);
+ if (options.backendFramework) {
+ findCatalogOverlay(templateEntry, options.backendFramework);
+ }
+
const nameArgs = await resolveArgs(
{
name: options.name
@@ -174,18 +204,7 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {
interactive,
);
- // Interactive runs always scaffold the Cloud backend; openui-self-hosted stays
- // available, but only when requested explicitly with --template.
- if (!options.template && !interactive) {
- throw new CreateError(
- "args_resolution",
- "Missing required argument --template",
- "invalid_input",
- "MISSING_REQUIRED_ARG",
- );
- }
- const template: TemplateName = options.template ?? "openui-cloud";
-
+ const overlayChoices = templateEntry.overlays;
const frameworkArgs = await resolveArgs(
{
backendFramework:
@@ -195,15 +214,11 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {
prompt: {
type: "select",
message: "Choose your backend framework",
- choices: [
- {
- value: "default",
- name: "Default — minimal SDK route",
- },
- { value: "vercel-ai-sdk", name: "Vercel AI SDK" },
- { value: "langgraph", name: "LangGraph" },
- { value: "vercel-eve", name: "Vercel Eve" },
- ],
+ choices: overlayChoices.map((overlay) => ({
+ value: overlay.key,
+ name: overlay.name,
+ description: overlay.description,
+ })),
},
required: true,
},
@@ -211,6 +226,7 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {
interactive,
);
const backendFramework = (frameworkArgs as { backendFramework: OverlayName }).backendFramework;
+ findCatalogOverlay(templateEntry, backendFramework);
const aiSetup = aiSetupFromTemplate(template);
telemetry.register({ template, ai_setup: aiSetup, backend_framework: backendFramework });
@@ -229,17 +245,6 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {
: "default",
});
- const templateDir = path.join(__dirname, "..", "templates", template);
- if (!fs.existsSync(templateDir)) {
- throw new CreateError(
- "preflight",
- `Template "${template}" not found. Rebuild the CLI with \`pnpm build\`.`,
- "filesystem",
- "TEMPLATE_MISSING",
- );
- }
- const overlay = resolveOverlay(templateDir, backendFramework);
-
telemetry.capture("cli_env_resolution_started", {
...createFunnelProps("env_resolution_started"),
template,
@@ -266,80 +271,80 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {
selection_source: immediateResolution.source,
});
- console.info(`\nScaffolding ${template} into "${name}"...\n`);
- telemetry.capture("cli_scaffold_started", {
- ...createFunnelProps("scaffold_started"),
- template,
- ai_setup: aiSetup,
- });
- try {
- fs.cpSync(templateDir, targetDir, {
- recursive: true,
- filter: (src) => shouldCopyTemplatePath(templateDir, src),
- });
- restoreDotfiles(targetDir);
- applyOverlay(targetDir, overlay);
- rewritePackageJson(targetDir, name, packageManager.name, overlay?.manifest.packageJson);
- // An overlay that changes dependencies without a lock must not keep the base lock
- const overlayShipsNpmLock = Boolean(
- overlay && fs.existsSync(path.join(overlay.dir, "package-lock.json")),
- );
- if (packageManager.name !== "npm" || (overlay && !overlayShipsNpmLock)) {
- fs.rmSync(path.join(targetDir, "package-lock.json"), { force: true });
- }
- // The Cloud template ships pnpm's lock/workspace files for reproducible pnpm
- // installs and native-build policy. A framework changes dependencies, so
- // regenerate its lock; non-pnpm scaffolds do not need either pnpm file.
- if (packageManager.name !== "pnpm" || backendFramework !== "default") {
- fs.rmSync(path.join(targetDir, "pnpm-lock.yaml"), { force: true });
- }
- if (packageManager.name !== "pnpm") {
- fs.rmSync(path.join(targetDir, "pnpm-workspace.yaml"), { force: true });
- }
- } catch (err) {
- const properties = cliErrorProperties(err, {
- failure_stage: "scaffold",
- error_class: "filesystem",
- error_code: "SCAFFOLD_FAILED",
- });
- telemetry.capture("cli_scaffold_failed", {
- ...createFunnelProps("scaffold_failed"),
+ let overlay: TemplateOverlay | undefined;
+ const runScaffold = async () => {
+ const { dir: templateDir } = await resolveTemplateSource(template);
+ telemetry.capture("cli_scaffold_started", {
+ ...createFunnelProps("scaffold_started"),
template,
ai_setup: aiSetup,
- ...properties,
});
- throw new CreateError(
- properties.failure_stage,
- err instanceof Error ? err.message : String(err),
- properties.error_class,
- properties.error_code,
- );
+ try {
+ overlay = resolveOverlay(templateDir, backendFramework);
+ fs.cpSync(templateDir, targetDir, {
+ recursive: true,
+ filter: (src) => shouldCopyTemplatePath(templateDir, src),
+ });
+ restoreDotfiles(targetDir);
+ applyOverlay(targetDir, overlay);
+ rewritePackageJson(targetDir, name, packageManager.name, overlay?.manifest.packageJson);
+ // An overlay that changes dependencies without a lock must not keep the base lock
+ const overlayShipsNpmLock = Boolean(
+ overlay && fs.existsSync(path.join(overlay.dir, "package-lock.json")),
+ );
+ if (packageManager.name !== "npm" || (overlay && !overlayShipsNpmLock)) {
+ fs.rmSync(path.join(targetDir, "package-lock.json"), { force: true });
+ }
+ // The Cloud template ships pnpm's lock/workspace files for reproducible pnpm
+ // installs and native-build policy. A framework changes dependencies, so
+ // regenerate its lock; non-pnpm scaffolds do not need either pnpm file.
+ if (packageManager.name !== "pnpm" || backendFramework !== "default") {
+ fs.rmSync(path.join(targetDir, "pnpm-lock.yaml"), { force: true });
+ }
+ if (packageManager.name !== "pnpm") {
+ fs.rmSync(path.join(targetDir, "pnpm-workspace.yaml"), { force: true });
+ }
+ await writeEnv(
+ targetDir,
+ envResult,
+ template === "openui-cloud" ? buildAppId(name) : undefined,
+ );
+ } catch (err) {
+ const properties = cliErrorProperties(err, {
+ failure_stage: "scaffold",
+ error_class: "filesystem",
+ error_code: "SCAFFOLD_FAILED",
+ });
+ telemetry.capture("cli_scaffold_failed", {
+ ...createFunnelProps("scaffold_failed"),
+ template,
+ ai_setup: aiSetup,
+ ...properties,
+ });
+ throw new CreateError(
+ properties.failure_stage,
+ err instanceof Error ? err.message : String(err),
+ properties.error_class,
+ properties.error_code,
+ );
+ } finally {
+ fs.rmSync(templateDir, { recursive: true, force: true });
+ }
+ };
+
+ console.info();
+ if (options.verbose) {
+ console.info(`Scaffolding ${template} into "${name}"...\n`);
+ await runScaffold();
+ } else {
+ await withSpinner("Scaffolding...", runScaffold);
+ console.info("✓ Scaffolded");
}
telemetry.capture("cli_scaffold_succeeded", {
...createFunnelProps("scaffold_succeeded"),
template,
ai_setup: aiSetup,
});
-
- try {
- await writeEnv(
- targetDir,
- envResult,
- template === "openui-cloud" ? buildAppId(name) : undefined,
- );
- } catch (err) {
- const properties = cliErrorProperties(err, {
- failure_stage: "environment_write",
- error_class: "filesystem",
- error_code: "WRITE_FAILED",
- });
- throw new CreateError(
- properties.failure_stage,
- err instanceof Error ? err.message : String(err),
- properties.error_class,
- properties.error_code,
- );
- }
telemetry.capture("cli_env_resolved", {
...createFunnelProps("env_written"),
template,
@@ -349,51 +354,6 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {
auth_succeeded: envResult.authSucceeded,
});
- let skillInstalled = false;
- if (installSkill) {
- telemetry.capture("cli_skill_install_started", {
- ...createFunnelProps("skill_install_started"),
- skill_installed: installSkill,
- });
- const skillResult = await runSkillInstall(targetDir);
- skillInstalled = !skillResult.error && skillResult.status === 0;
- if (skillInstalled) {
- telemetry.capture("cli_skill_install_finished", {
- ...createFunnelProps("skill_install_finished"),
- skill_installed: true,
- duration_ms: skillResult.durationMs,
- exit_code: skillResult.status,
- });
- } else {
- const properties = processErrorProperties(skillResult, "skill_install", {
- error_class: "dependency",
- error_code: "SKILL_INSTALL_FAILED",
- });
- if (properties.error_class === "user_cancelled") {
- telemetry.capture("cli_skill_install_cancelled", {
- ...createFunnelProps("skill_install_cancelled"),
- skill_installed: false,
- ...properties,
- });
- throw new CliCancelledError(
- "skill_install",
- properties.cancellation_exit_code ?? 0,
- properties,
- );
- }
- telemetry.capture("cli_skill_install_failed", {
- ...createFunnelProps("skill_install_failed"),
- skill_installed: false,
- ...properties,
- });
- console.warn(
- "\nCould not install the OpenUI agent skill automatically.\n" +
- "You can install it manually later with:\n\n" +
- " npx skills add thesysdev/skills --skill openui\n",
- );
- }
- }
-
// Framework scaffolds without an npm lock must resolve ranges against the
// registry (`npm install`). When a backend overlay ships package-lock.json,
// keep the normal `npm ci` path. --prefer-offline is only safe for `npm ci`,
@@ -419,7 +379,7 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {
telemetry.capture("cli_dependency_install_skipped", {
skip_reason: "no_install_flag",
});
- console.info(`Skipping dependency install (--no-install). Run \`${installCmd}\` later.\n`);
+ console.info(`Skipping dependency install (--no-install). Run \`${installCmd}\` later.`);
} else {
telemetry.capture("cli_dependency_install_started", {
...createFunnelProps("dependency_install_started"),
@@ -449,7 +409,7 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {
if (!installResult.error && installResult.status === 0) {
dependencyInstalled = true;
if (!options.verbose) {
- console.info("✓ Dependencies installed\n");
+ console.info("✓ Dependencies installed");
}
telemetry.capture("cli_dependency_install_succeeded", {
...createFunnelProps("dependency_install_succeeded"),
@@ -497,6 +457,67 @@ export async function runCreateApp(options: CreateAppOptions): Promise<void> {
}
}
+ let skillInstalled = false;
+ if (installSkill) {
+ telemetry.capture("cli_skill_install_started", {
+ ...createFunnelProps("skill_install_started"),
+ skill_installed: installSkill,
+ });
+ const runSkill = () =>
+ options.verbose
+ ? runSkillInstall(targetDir)
+ : runSkillInstall(targetDir, {
+ echo: false,
+ stdin: "ignore",
+ captureLimit: QUIET_COMMAND_CAPTURE_LIMIT,
+ });
+ if (options.verbose) {
+ console.info("Installing OpenUI agent skill...\n");
+ }
+ const skillResult = options.verbose
+ ? await runSkill()
+ : await withSpinner("Installing OpenUI agent skill...", runSkill);
+ skillInstalled = !skillResult.error && skillResult.status === 0;
+ if (skillInstalled) {
+ if (!options.verbose) {
+ console.info("✓ OpenUI agent skill installed");
+ }
+ telemetry.capture("cli_skill_install_finished", {
+ ...createFunnelProps("skill_install_finished"),
+ skill_installed: true,
+ duration_ms: skillResult.durationMs,
+ exit_code: skillResult.status,
+ });
+ } else {
+ const properties = processErrorProperties(skillResult, "skill_install", {
+ error_class: "dependency",
+ error_code: "SKILL_INSTALL_FAILED",
+ });
+ if (properties.error_class === "user_cancelled") {
+ telemetry.capture("cli_skill_install_cancelled", {
+ ...createFunnelProps("skill_install_cancelled"),
+ skill_installed: false,
+ ...properties,
+ });
+ throw new CliCancelledError(
+ "skill_install",
+ properties.cancellation_exit_code ?? 0,
+ properties,
+ );
+ }
+ telemetry.capture("cli_skill_install_failed", {
+ ...createFunnelProps("skill_install_failed"),
+ skill_installed: false,
+ ...properties,
+ });
+ console.warn(
+ "\nCould not install the OpenUI agent skill automatically.\n" +
+ "You can install it manually later with:\n\n" +
+ " npx skills add thesysdev/skills --skill openui\n",
+ );
+ }
+ }
+
const devCmd = packageManager.runCmd;
const startDev =
immediateResolution.immediate && dependencyInstalled && !devStartBlockedByMissingApiKey;
@@ -752,7 +773,7 @@ function getStartedMessage(o: {
const frameworkNote = o.backendGettingStarted?.replaceAll("{{packageManager}}", o.devCmd) ?? "";
- return `${[skillMessage.trim(), "Done!", envNote, frameworkNote, nextStep]
+ return `\n${[skillMessage.trim(), "Done!", envNote, frameworkNote, nextStep]
.filter(Boolean)
.join("\n\n")}\n`;
}
diff --git a/packages/openui-cli/src/lib/create-types.ts b/packages/openui-cli/src/lib/create-types.ts
index 83e274ab0..db853defb 100644
--- a/packages/openui-cli/src/lib/create-types.ts
+++ b/packages/openui-cli/src/lib/create-types.ts
@@ -1,8 +1,9 @@
import type { CloudAuthMethod, ResolvedAuthMethod } from "../auth/mint";
-export type TemplateName = "openui-self-hosted" | "openui-cloud";
-/** On-disk overlay under `overlays/<name>/`. Selected via `--backend-framework`. */
-export type OverlayName = "default" | "langgraph" | "vercel-ai-sdk" | "vercel-eve";
+/** Template `key` from `templates/templates.json`. */
+export type TemplateName = string;
+/** Overlay `key` from the selected template's `overlays` list, or `default`. */
+export type OverlayName = string;
export interface CreateAppOptions {
name?: string;
diff --git a/packages/openui-cli/src/lib/install-skill.ts b/packages/openui-cli/src/lib/install-skill.ts
index 465341420..28cf8c2ca 100644
--- a/packages/openui-cli/src/lib/install-skill.ts
+++ b/packages/openui-cli/src/lib/install-skill.ts
@@ -1,4 +1,4 @@
-import { runCommand, type CommandResult } from "./process-runner";
+import { runCommand, type CommandResult, type RunCommandOptions } from "./process-runner";
import { CliCancelledError } from "./telemetry";
const OPENUI_SKILL_SOURCE = "thesysdev/skills";
@@ -25,11 +25,14 @@ export async function shouldInstallSkill(
}
}
-export async function runSkillInstall(targetDir: string): Promise<CommandResult> {
- console.info("\nInstalling OpenUI agent skill...\n");
+export async function runSkillInstall(
+ targetDir: string,
+ options: RunCommandOptions = {},
+): Promise<CommandResult> {
return runCommand(
"npx",
["-y", "skills", "add", OPENUI_SKILL_SOURCE, "--skill", "openui", "-y"],
targetDir,
+ options,
);
}
diff --git a/packages/openui-cli/src/lib/overlays.ts b/packages/openui-cli/src/lib/overlays.ts
index bfc4b20ad..cbef9c80d 100644
--- a/packages/openui-cli/src/lib/overlays.ts
+++ b/packages/openui-cli/src/lib/overlays.ts
@@ -1,6 +1,6 @@
import * as fs from "node:fs";
import * as path from "node:path";
-import { OverlayName } from "./create-types";
+
import { CreateError } from "./telemetry";
export const OVERLAYS_DIR = "overlays";
@@ -12,6 +12,10 @@ export const OVERLAY_MANIFEST = "manifest.json";
* other surface the overlay needs to touch.
*/
export type OverlayManifest = {
+ /** Prompt label for `--backend-framework` / the interactive picker. */
+ label?: string;
+ /** Optional prompt description. */
+ description?: string;
/** Merged into the scaffolded package.json. */
packageJson?: {
dependencies?: Record<string, string>;
@@ -34,18 +38,56 @@ export type TemplateOverlay = {
manifest: OverlayManifest;
};
+export type OverlayChoice = {
+ name: string;
+ label: string;
+ description?: string;
+};
+
+const DEFAULT_OVERLAY: OverlayChoice = {
+ name: "default",
+ label: "Default — minimal SDK route",
+ description: "Minimal SDK route",
+};
+
+export function listOverlays(templateDir: string): OverlayChoice[] {
+ const overlaysDir = path.join(templateDir, OVERLAYS_DIR);
+ const choices = [DEFAULT_OVERLAY];
+ if (!fs.existsSync(overlaysDir)) return choices;
+
+ const extra: OverlayChoice[] = [];
+ for (const entry of fs.readdirSync(overlaysDir, { withFileTypes: true })) {
+ if (!entry.isDirectory()) continue;
+ const manifestPath = path.join(overlaysDir, entry.name, OVERLAY_MANIFEST);
+ if (!fs.existsSync(manifestPath)) continue;
+ const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8")) as OverlayManifest;
+ extra.push({
+ name: entry.name,
+ label: manifest.label ?? entry.name,
+ description: manifest.description,
+ });
+ }
+ extra.sort((a, b) => a.name.localeCompare(b.name));
+ return [...choices, ...extra];
+}
+
export function resolveOverlay(
templateDir: string,
- overlayName: OverlayName,
+ overlayName: string,
): TemplateOverlay | undefined {
if (overlayName === "default") return undefined;
const overlayDir = path.join(templateDir, OVERLAYS_DIR, overlayName);
const manifestPath = path.join(overlayDir, OVERLAY_MANIFEST);
if (!fs.existsSync(manifestPath)) {
+ const available = listOverlays(templateDir)
+ .map((overlay) => overlay.name)
+ .join(" | ");
throw new CreateError(
"template_missing",
- `Backend framework "${overlayName}" not found. Rebuild the CLI with \`pnpm build\`.`,
+ `Backend framework "${overlayName}" not found. Use: ${available}.`,
+ "invalid_input",
+ "INVALID_BACKEND_FRAMEWORK",
);
}
diff --git a/packages/openui-cli/src/lib/resolve-args.ts b/packages/openui-cli/src/lib/resolve-args.ts
index 89ab681e5..53bd78035 100644
--- a/packages/openui-cli/src/lib/resolve-args.ts
+++ b/packages/openui-cli/src/lib/resolve-args.ts
@@ -33,7 +33,11 @@ export function rejectConflictingImmediateFlags(args: string[]): void {
async function resolveOne(prompt: PromptConfig): Promise<string> {
const { input, select } = await import("@inquirer/prompts");
if (prompt.type === "select") {
- return select({ message: prompt.message, choices: prompt.choices });
+ return select({
+ message: prompt.message,
+ choices: prompt.choices,
+ pageSize: prompt.choices.length,
+ });
}
return input({ message: prompt.message, default: prompt.default });
}
diff --git a/packages/openui-cli/src/lib/scaffold-template.ts b/packages/openui-cli/src/lib/scaffold-template.ts
new file mode 100644
index 000000000..3638d5423
--- /dev/null
+++ b/packages/openui-cli/src/lib/scaffold-template.ts
@@ -0,0 +1,29 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+
+import { checkoutSource } from "./checkout";
+import { CreateError } from "./telemetry";
+
+export const TEMPLATES_DIR = "templates";
+
+export type ResolvedTemplate = {
+ dir: string;
+};
+
+export async function resolveTemplateSource(template: string): Promise<ResolvedTemplate> {
+ const dest = fs.mkdtempSync(path.join(os.tmpdir(), "openui-template-"));
+ try {
+ const checkedOut = await checkoutSource(`${TEMPLATES_DIR}/${template}`, { dest });
+ return { dir: checkedOut.dir };
+ } catch (err) {
+ fs.rmSync(dest, { recursive: true, force: true });
+ if (err instanceof CreateError) throw err;
+ throw new CreateError(
+ "preflight",
+ err instanceof Error ? err.message : String(err),
+ "network",
+ "TEMPLATE_MISSING",
+ );
+ }
+}
diff --git a/packages/openui-cli/src/lib/templates-catalog.ts b/packages/openui-cli/src/lib/templates-catalog.ts
new file mode 100644
index 000000000..feb36da32
--- /dev/null
+++ b/packages/openui-cli/src/lib/templates-catalog.ts
@@ -0,0 +1,98 @@
+import { fetchSourceFile } from "./checkout";
+import { CreateError } from "./telemetry";
+
+export const TEMPLATES_CATALOG_PATH = "templates/templates.json";
+
+export const DEFAULT_TEMPLATE_KEY = "openui-cloud";
+
+export type CatalogOverlay = {
+ name: string;
+ key: string;
+ description: string;
+};
+
+export type CatalogTemplate = {
+ name: string;
+ key: string;
+ description: string;
+ overlays: CatalogOverlay[];
+};
+
+function catalogError(message: string): CreateError {
+ return new CreateError("args_resolution", message, "invalid_input", "TEMPLATE_CATALOG_INVALID");
+}
+
+function parseOverlay(item: unknown): CatalogOverlay {
+ const overlay = item as CatalogOverlay;
+ if (
+ typeof overlay?.name !== "string" ||
+ typeof overlay?.key !== "string" ||
+ typeof overlay?.description !== "string"
+ ) {
+ throw catalogError(
+ `${TEMPLATES_CATALOG_PATH} has an overlay missing name, key, or description.`,
+ );
+ }
+ return overlay;
+}
+
+function parseTemplate(item: unknown): CatalogTemplate {
+ const template = item as CatalogTemplate;
+ if (
+ typeof template?.name !== "string" ||
+ typeof template?.key !== "string" ||
+ typeof template?.description !== "string"
+ ) {
+ throw catalogError(
+ `${TEMPLATES_CATALOG_PATH} has a template missing name, key, or description.`,
+ );
+ }
+ if (!Array.isArray(template.overlays) || template.overlays.length === 0) {
+ throw catalogError(`Template "${template.key}" has no overlays.`);
+ }
+ return { ...template, overlays: template.overlays.map(parseOverlay) };
+}
+
+function parseTemplatesCatalog(raw: string): CatalogTemplate[] {
+ const parsed = JSON.parse(raw) as { templates?: unknown };
+ if (!Array.isArray(parsed.templates) || parsed.templates.length === 0) {
+ throw catalogError(`${TEMPLATES_CATALOG_PATH} must contain a non-empty "templates" array.`);
+ }
+ return parsed.templates.map(parseTemplate);
+}
+
+/** Prefetch the template catalog from GitHub. */
+export async function loadTemplatesCatalog(): Promise<CatalogTemplate[]> {
+ const { content } = await fetchSourceFile(TEMPLATES_CATALOG_PATH);
+ return parseTemplatesCatalog(content);
+}
+
+export function findCatalogTemplate(templates: CatalogTemplate[], key: string): CatalogTemplate {
+ const normalized = key.toLowerCase();
+ const match = templates.find((entry) => entry.key.toLowerCase() === normalized);
+ if (!match) {
+ const available = templates.map((entry) => entry.key).join(" | ");
+ throw new CreateError(
+ "args_resolution",
+ `unknown template "${key}". Use: ${available}.`,
+ "invalid_input",
+ "INVALID_TEMPLATE",
+ );
+ }
+ return match;
+}
+
+export function findCatalogOverlay(template: CatalogTemplate, key: string): CatalogOverlay {
+ const normalized = key.toLowerCase();
+ const match = template.overlays.find((entry) => entry.key.toLowerCase() === normalized);
+ if (!match) {
+ const available = template.overlays.map((entry) => entry.key).join(" | ");
+ throw new CreateError(
+ "args_resolution",
+ `unknown backend framework "${key}". Use: ${available}.`,
+ "invalid_input",
+ "INVALID_BACKEND_FRAMEWORK",
+ );
+ }
+ return match;
+}
diff --git a/packages/openui-cli/src/lib/utils.ts b/packages/openui-cli/src/lib/utils.ts
index b4f63d363..e3f0dbd8b 100644
--- a/packages/openui-cli/src/lib/utils.ts
+++ b/packages/openui-cli/src/lib/utils.ts
@@ -228,12 +228,7 @@ export function normalizeTemplate(t?: string): TemplateName | undefined {
const v = t.toLowerCase();
if (v === "self-hosted" || v === "openui-self-hosted") return "openui-self-hosted";
if (v === "cloud" || v === "openui-cloud") return "openui-cloud";
- throw new CreateError(
- "args_resolution",
- `unknown template "${t}". Use: openui-self-hosted | openui-cloud.`,
- "invalid_input",
- "INVALID_TEMPLATE",
- );
+ return v;
}
export function normalizeAuth(a?: string): CloudAuthMethod | undefined {
@@ -266,9 +261,6 @@ export function normalizeBackendFramework(framework?: string): OverlayName | und
case "vercel-eve":
return "vercel-eve";
default:
- throw new CreateError(
- "bad_args",
- `unknown backend framework "${framework}". Use: default | langgraph | vercel-ai-sdk | vercel-eve.`,
- );
+ return framework.toLowerCase();
}
}
diff --git a/packages/openui-cli/tsconfig.json b/packages/openui-cli/tsconfig.json
index a998f5c59..07421f2f0 100644
--- a/packages/openui-cli/tsconfig.json
+++ b/packages/openui-cli/tsconfig.json
@@ -2,7 +2,7 @@
"$schema": "https://json.schemastore.org/tsconfig",
"extends": "../../tsconfig.json",
"include": ["src/**/*.ts"],
- "exclude": ["src/playground", "src/templates"],
+ "exclude": ["src/playground"],
"compilerOptions": {
"target": "es2022",
"lib": ["es2022"],
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 0c7eb2385..dcbe889da 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -395,9 +395,6 @@ importers:
'@types/node':
specifier: 'catalog:'
version: 22.20.1
- rimraf:
- specifier: ^5.0.7
- version: 5.0.10
packages/react-email:
dependencies:
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index b99fe1d55..8e11a7fc9 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -1,7 +1,7 @@
packages:
- "packages/*"
- "docs/"
- - "!**/src/templates/**"
+ - "!templates/**"
# Centralized dependency versions shared across packages.
# Reference these from a package.json with the "catalog:" protocol.
diff --git a/templates/README.md b/templates/README.md
new file mode 100644
index 000000000..70aca9455
--- /dev/null
+++ b/templates/README.md
@@ -0,0 +1,8 @@
+# CLI templates
+
+Starter apps for `openui create`. `templates.json` is the catalog file.
+
+| Directory | `--template` |
+| --- | --- |
+| `openui-cloud/` | `openui-cloud` (interactive default) |
+| `openui-self-hosted/` | `openui-self-hosted` |
diff --git a/packages/openui-cli/src/templates/openui-cloud/README.md b/templates/openui-cloud/README.md
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/README.md
rename to templates/openui-cloud/README.md
diff --git a/packages/openui-cli/src/templates/openui-cloud/eslint.config.mjs b/templates/openui-cloud/eslint.config.mjs
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/eslint.config.mjs
rename to templates/openui-cloud/eslint.config.mjs
diff --git a/packages/openui-cli/src/templates/openui-cloud/gitignore b/templates/openui-cloud/gitignore
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/gitignore
rename to templates/openui-cloud/gitignore
diff --git a/packages/openui-cli/src/templates/openui-cloud/next.config.ts b/templates/openui-cloud/next.config.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/next.config.ts
rename to templates/openui-cloud/next.config.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/langgraph/manifest.json b/templates/openui-cloud/overlays/langgraph/manifest.json
similarity index 86%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/langgraph/manifest.json
rename to templates/openui-cloud/overlays/langgraph/manifest.json
index 9cf357bfb..eb26640ce 100644
--- a/packages/openui-cli/src/templates/openui-cloud/overlays/langgraph/manifest.json
+++ b/templates/openui-cloud/overlays/langgraph/manifest.json
@@ -1,4 +1,6 @@
{
+ "label": "LangGraph",
+ "description": "LangGraph agent with the selected model backend",
"packageJson": {
"dependencies": {
"@langchain/core": "^1.2.5",
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/langgraph/package-lock.json b/templates/openui-cloud/overlays/langgraph/package-lock.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/langgraph/package-lock.json
rename to templates/openui-cloud/overlays/langgraph/package-lock.json
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/langgraph/src/agent.ts b/templates/openui-cloud/overlays/langgraph/src/agent.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/langgraph/src/agent.ts
rename to templates/openui-cloud/overlays/langgraph/src/agent.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/langgraph/src/app/api/chat/route.ts b/templates/openui-cloud/overlays/langgraph/src/app/api/chat/route.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/langgraph/src/app/api/chat/route.ts
rename to templates/openui-cloud/overlays/langgraph/src/app/api/chat/route.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/langgraph/src/components/cloud-chat.tsx b/templates/openui-cloud/overlays/langgraph/src/components/cloud-chat.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/langgraph/src/components/cloud-chat.tsx
rename to templates/openui-cloud/overlays/langgraph/src/components/cloud-chat.tsx
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/manifest.json b/templates/openui-cloud/overlays/vercel-ai-sdk/manifest.json
similarity index 81%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/manifest.json
rename to templates/openui-cloud/overlays/vercel-ai-sdk/manifest.json
index df398a57f..700ae3743 100644
--- a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/manifest.json
+++ b/templates/openui-cloud/overlays/vercel-ai-sdk/manifest.json
@@ -1,4 +1,6 @@
{
+ "label": "Vercel AI SDK",
+ "description": "Vercel AI SDK agent with the selected model backend",
"packageJson": {
"dependencies": {
"@ai-sdk/openai": "^3.0.91",
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/package-lock.json b/templates/openui-cloud/overlays/vercel-ai-sdk/package-lock.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/package-lock.json
rename to templates/openui-cloud/overlays/vercel-ai-sdk/package-lock.json
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/src/app/api/chat/route.ts b/templates/openui-cloud/overlays/vercel-ai-sdk/src/app/api/chat/route.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/src/app/api/chat/route.ts
rename to templates/openui-cloud/overlays/vercel-ai-sdk/src/app/api/chat/route.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/src/components/cloud-chat.tsx b/templates/openui-cloud/overlays/vercel-ai-sdk/src/components/cloud-chat.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/src/components/cloud-chat.tsx
rename to templates/openui-cloud/overlays/vercel-ai-sdk/src/components/cloud-chat.tsx
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/src/lib/starters.tsx b/templates/openui-cloud/overlays/vercel-ai-sdk/src/lib/starters.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/src/lib/starters.tsx
rename to templates/openui-cloud/overlays/vercel-ai-sdk/src/lib/starters.tsx
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/src/lib/tools.ts b/templates/openui-cloud/overlays/vercel-ai-sdk/src/lib/tools.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-ai-sdk/src/lib/tools.ts
rename to templates/openui-cloud/overlays/vercel-ai-sdk/src/lib/tools.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/.npmrc b/templates/openui-cloud/overlays/vercel-eve/.npmrc
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/.npmrc
rename to templates/openui-cloud/overlays/vercel-eve/.npmrc
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/agent/agent.ts b/templates/openui-cloud/overlays/vercel-eve/agent/agent.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/agent/agent.ts
rename to templates/openui-cloud/overlays/vercel-eve/agent/agent.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/agent/channels/eve.ts b/templates/openui-cloud/overlays/vercel-eve/agent/channels/eve.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/agent/channels/eve.ts
rename to templates/openui-cloud/overlays/vercel-eve/agent/channels/eve.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/agent/instructions/identity.md b/templates/openui-cloud/overlays/vercel-eve/agent/instructions/identity.md
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/agent/instructions/identity.md
rename to templates/openui-cloud/overlays/vercel-eve/agent/instructions/identity.md
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/agent/instructions/openui.ts b/templates/openui-cloud/overlays/vercel-eve/agent/instructions/openui.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/agent/instructions/openui.ts
rename to templates/openui-cloud/overlays/vercel-eve/agent/instructions/openui.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/agent/tools/ask_question.ts b/templates/openui-cloud/overlays/vercel-eve/agent/tools/ask_question.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/agent/tools/ask_question.ts
rename to templates/openui-cloud/overlays/vercel-eve/agent/tools/ask_question.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/agent/tools/get_weather.ts b/templates/openui-cloud/overlays/vercel-eve/agent/tools/get_weather.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/agent/tools/get_weather.ts
rename to templates/openui-cloud/overlays/vercel-eve/agent/tools/get_weather.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/manifest.json b/templates/openui-cloud/overlays/vercel-eve/manifest.json
similarity index 89%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/manifest.json
rename to templates/openui-cloud/overlays/vercel-eve/manifest.json
index 17f3052b8..fa3892252 100644
--- a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/manifest.json
+++ b/templates/openui-cloud/overlays/vercel-eve/manifest.json
@@ -1,4 +1,6 @@
{
+ "label": "Vercel Eve",
+ "description": "Eve agent rendered through Agent Interface",
"packageJson": {
"dependencies": {
"@ai-sdk/openai": "^3.0.88",
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/next.config.ts b/templates/openui-cloud/overlays/vercel-eve/next.config.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/next.config.ts
rename to templates/openui-cloud/overlays/vercel-eve/next.config.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/package-lock.json b/templates/openui-cloud/overlays/vercel-eve/package-lock.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/package-lock.json
rename to templates/openui-cloud/overlays/vercel-eve/package-lock.json
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/src/components/cloud-chat.tsx b/templates/openui-cloud/overlays/vercel-eve/src/components/cloud-chat.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/src/components/cloud-chat.tsx
rename to templates/openui-cloud/overlays/vercel-eve/src/components/cloud-chat.tsx
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/src/eve-chat.ts b/templates/openui-cloud/overlays/vercel-eve/src/eve-chat.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/src/eve-chat.ts
rename to templates/openui-cloud/overlays/vercel-eve/src/eve-chat.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/tsconfig.json b/templates/openui-cloud/overlays/vercel-eve/tsconfig.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/overlays/vercel-eve/tsconfig.json
rename to templates/openui-cloud/overlays/vercel-eve/tsconfig.json
diff --git a/packages/openui-cli/src/templates/openui-cloud/package-lock.json b/templates/openui-cloud/package-lock.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/package-lock.json
rename to templates/openui-cloud/package-lock.json
diff --git a/packages/openui-cli/src/templates/openui-cloud/package.json b/templates/openui-cloud/package.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/package.json
rename to templates/openui-cloud/package.json
diff --git a/packages/openui-cli/src/templates/openui-cloud/pnpm-workspace.yaml b/templates/openui-cloud/pnpm-workspace.yaml
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/pnpm-workspace.yaml
rename to templates/openui-cloud/pnpm-workspace.yaml
diff --git a/packages/openui-cli/src/templates/openui-cloud/public/logos/anthropic-dark.svg b/templates/openui-cloud/public/logos/anthropic-dark.svg
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/public/logos/anthropic-dark.svg
rename to templates/openui-cloud/public/logos/anthropic-dark.svg
diff --git a/packages/openui-cli/src/templates/openui-cloud/public/logos/anthropic-light.svg b/templates/openui-cloud/public/logos/anthropic-light.svg
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/public/logos/anthropic-light.svg
rename to templates/openui-cloud/public/logos/anthropic-light.svg
diff --git a/packages/openui-cli/src/templates/openui-cloud/public/logos/google-dark.svg b/templates/openui-cloud/public/logos/google-dark.svg
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/public/logos/google-dark.svg
rename to templates/openui-cloud/public/logos/google-dark.svg
diff --git a/packages/openui-cli/src/templates/openui-cloud/public/logos/google-light.svg b/templates/openui-cloud/public/logos/google-light.svg
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/public/logos/google-light.svg
rename to templates/openui-cloud/public/logos/google-light.svg
diff --git a/packages/openui-cli/src/templates/openui-cloud/public/logos/openai-dark.svg b/templates/openui-cloud/public/logos/openai-dark.svg
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/public/logos/openai-dark.svg
rename to templates/openui-cloud/public/logos/openai-dark.svg
diff --git a/packages/openui-cli/src/templates/openui-cloud/public/logos/openai-light.svg b/templates/openui-cloud/public/logos/openai-light.svg
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/public/logos/openai-light.svg
rename to templates/openui-cloud/public/logos/openai-light.svg
diff --git a/packages/openui-cli/src/templates/openui-cloud/public/openui-cloud-logo-dark.svg b/templates/openui-cloud/public/openui-cloud-logo-dark.svg
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/public/openui-cloud-logo-dark.svg
rename to templates/openui-cloud/public/openui-cloud-logo-dark.svg
diff --git a/packages/openui-cli/src/templates/openui-cloud/public/openui-cloud-logo-light.svg b/templates/openui-cloud/public/openui-cloud-logo-light.svg
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/public/openui-cloud-logo-light.svg
rename to templates/openui-cloud/public/openui-cloud-logo-light.svg
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/app/api/chat/route.ts b/templates/openui-cloud/src/app/api/chat/route.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/app/api/chat/route.ts
rename to templates/openui-cloud/src/app/api/chat/route.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/app/api/frontend-token/route.ts b/templates/openui-cloud/src/app/api/frontend-token/route.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/app/api/frontend-token/route.ts
rename to templates/openui-cloud/src/app/api/frontend-token/route.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/app/globals.css b/templates/openui-cloud/src/app/globals.css
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/app/globals.css
rename to templates/openui-cloud/src/app/globals.css
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/app/icon.svg b/templates/openui-cloud/src/app/icon.svg
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/app/icon.svg
rename to templates/openui-cloud/src/app/icon.svg
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/app/layout.tsx b/templates/openui-cloud/src/app/layout.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/app/layout.tsx
rename to templates/openui-cloud/src/app/layout.tsx
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/app/page.tsx b/templates/openui-cloud/src/app/page.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/app/page.tsx
rename to templates/openui-cloud/src/app/page.tsx
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/components/cloud-chat.tsx b/templates/openui-cloud/src/components/cloud-chat.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/components/cloud-chat.tsx
rename to templates/openui-cloud/src/components/cloud-chat.tsx
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/hooks/use-persisted-model.ts b/templates/openui-cloud/src/hooks/use-persisted-model.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/hooks/use-persisted-model.ts
rename to templates/openui-cloud/src/hooks/use-persisted-model.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/lib/env.ts b/templates/openui-cloud/src/lib/env.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/lib/env.ts
rename to templates/openui-cloud/src/lib/env.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/lib/models.tsx b/templates/openui-cloud/src/lib/models.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/lib/models.tsx
rename to templates/openui-cloud/src/lib/models.tsx
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/lib/starters.tsx b/templates/openui-cloud/src/lib/starters.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/lib/starters.tsx
rename to templates/openui-cloud/src/lib/starters.tsx
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/lib/tool-loop.ts b/templates/openui-cloud/src/lib/tool-loop.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/lib/tool-loop.ts
rename to templates/openui-cloud/src/lib/tool-loop.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/src/lib/tools/get-weather.ts b/templates/openui-cloud/src/lib/tools/get-weather.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/src/lib/tools/get-weather.ts
rename to templates/openui-cloud/src/lib/tools/get-weather.ts
diff --git a/packages/openui-cli/src/templates/openui-cloud/tsconfig.json b/templates/openui-cloud/tsconfig.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-cloud/tsconfig.json
rename to templates/openui-cloud/tsconfig.json
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/README.md b/templates/openui-self-hosted/README.md
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/README.md
rename to templates/openui-self-hosted/README.md
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/eslint.config.mjs b/templates/openui-self-hosted/eslint.config.mjs
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/eslint.config.mjs
rename to templates/openui-self-hosted/eslint.config.mjs
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/gitignore b/templates/openui-self-hosted/gitignore
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/gitignore
rename to templates/openui-self-hosted/gitignore
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/next.config.ts b/templates/openui-self-hosted/next.config.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/next.config.ts
rename to templates/openui-self-hosted/next.config.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/langgraph/manifest.json b/templates/openui-self-hosted/overlays/langgraph/manifest.json
similarity index 85%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/langgraph/manifest.json
rename to templates/openui-self-hosted/overlays/langgraph/manifest.json
index dee5fb594..cb337a5cd 100644
--- a/packages/openui-cli/src/templates/openui-self-hosted/overlays/langgraph/manifest.json
+++ b/templates/openui-self-hosted/overlays/langgraph/manifest.json
@@ -1,4 +1,6 @@
{
+ "label": "LangGraph",
+ "description": "LangGraph agent with the selected model backend",
"packageJson": {
"dependencies": {
"@langchain/core": "^1.2.5",
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/langgraph/package-lock.json b/templates/openui-self-hosted/overlays/langgraph/package-lock.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/langgraph/package-lock.json
rename to templates/openui-self-hosted/overlays/langgraph/package-lock.json
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/langgraph/src/agent.ts b/templates/openui-self-hosted/overlays/langgraph/src/agent.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/langgraph/src/agent.ts
rename to templates/openui-self-hosted/overlays/langgraph/src/agent.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/langgraph/src/app/api/chat/route.ts b/templates/openui-self-hosted/overlays/langgraph/src/app/api/chat/route.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/langgraph/src/app/api/chat/route.ts
rename to templates/openui-self-hosted/overlays/langgraph/src/app/api/chat/route.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/langgraph/src/app/page.tsx b/templates/openui-self-hosted/overlays/langgraph/src/app/page.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/langgraph/src/app/page.tsx
rename to templates/openui-self-hosted/overlays/langgraph/src/app/page.tsx
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-ai-sdk/manifest.json b/templates/openui-self-hosted/overlays/vercel-ai-sdk/manifest.json
similarity index 75%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-ai-sdk/manifest.json
rename to templates/openui-self-hosted/overlays/vercel-ai-sdk/manifest.json
index 57ba335ec..793e89b10 100644
--- a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-ai-sdk/manifest.json
+++ b/templates/openui-self-hosted/overlays/vercel-ai-sdk/manifest.json
@@ -1,4 +1,6 @@
{
+ "label": "Vercel AI SDK",
+ "description": "Vercel AI SDK agent with the selected model backend",
"packageJson": {
"dependencies": {
"@ai-sdk/openai": "3.0.90",
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-ai-sdk/package-lock.json b/templates/openui-self-hosted/overlays/vercel-ai-sdk/package-lock.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-ai-sdk/package-lock.json
rename to templates/openui-self-hosted/overlays/vercel-ai-sdk/package-lock.json
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-ai-sdk/src/app/api/chat/route.ts b/templates/openui-self-hosted/overlays/vercel-ai-sdk/src/app/api/chat/route.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-ai-sdk/src/app/api/chat/route.ts
rename to templates/openui-self-hosted/overlays/vercel-ai-sdk/src/app/api/chat/route.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-ai-sdk/src/app/page.tsx b/templates/openui-self-hosted/overlays/vercel-ai-sdk/src/app/page.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-ai-sdk/src/app/page.tsx
rename to templates/openui-self-hosted/overlays/vercel-ai-sdk/src/app/page.tsx
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/.npmrc b/templates/openui-self-hosted/overlays/vercel-eve/.npmrc
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/.npmrc
rename to templates/openui-self-hosted/overlays/vercel-eve/.npmrc
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/agent/agent.ts b/templates/openui-self-hosted/overlays/vercel-eve/agent/agent.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/agent/agent.ts
rename to templates/openui-self-hosted/overlays/vercel-eve/agent/agent.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/agent/channels/eve.ts b/templates/openui-self-hosted/overlays/vercel-eve/agent/channels/eve.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/agent/channels/eve.ts
rename to templates/openui-self-hosted/overlays/vercel-eve/agent/channels/eve.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/agent/instructions/identity.md b/templates/openui-self-hosted/overlays/vercel-eve/agent/instructions/identity.md
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/agent/instructions/identity.md
rename to templates/openui-self-hosted/overlays/vercel-eve/agent/instructions/identity.md
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/agent/instructions/openui.ts b/templates/openui-self-hosted/overlays/vercel-eve/agent/instructions/openui.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/agent/instructions/openui.ts
rename to templates/openui-self-hosted/overlays/vercel-eve/agent/instructions/openui.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/agent/tools/ask_question.ts b/templates/openui-self-hosted/overlays/vercel-eve/agent/tools/ask_question.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/agent/tools/ask_question.ts
rename to templates/openui-self-hosted/overlays/vercel-eve/agent/tools/ask_question.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/agent/tools/get_weather.ts b/templates/openui-self-hosted/overlays/vercel-eve/agent/tools/get_weather.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/agent/tools/get_weather.ts
rename to templates/openui-self-hosted/overlays/vercel-eve/agent/tools/get_weather.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/manifest.json b/templates/openui-self-hosted/overlays/vercel-eve/manifest.json
similarity index 88%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/manifest.json
rename to templates/openui-self-hosted/overlays/vercel-eve/manifest.json
index 14c4406a7..42cdc1f98 100644
--- a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/manifest.json
+++ b/templates/openui-self-hosted/overlays/vercel-eve/manifest.json
@@ -1,4 +1,6 @@
{
+ "label": "Vercel Eve",
+ "description": "Eve agent rendered through Agent Interface",
"packageJson": {
"dependencies": {
"@ai-sdk/openai": "^3.0.88",
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/next.config.ts b/templates/openui-self-hosted/overlays/vercel-eve/next.config.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/next.config.ts
rename to templates/openui-self-hosted/overlays/vercel-eve/next.config.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/package-lock.json b/templates/openui-self-hosted/overlays/vercel-eve/package-lock.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/package-lock.json
rename to templates/openui-self-hosted/overlays/vercel-eve/package-lock.json
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/src/app/page.tsx b/templates/openui-self-hosted/overlays/vercel-eve/src/app/page.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/src/app/page.tsx
rename to templates/openui-self-hosted/overlays/vercel-eve/src/app/page.tsx
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/src/eve-chat.ts b/templates/openui-self-hosted/overlays/vercel-eve/src/eve-chat.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/src/eve-chat.ts
rename to templates/openui-self-hosted/overlays/vercel-eve/src/eve-chat.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/tsconfig.json b/templates/openui-self-hosted/overlays/vercel-eve/tsconfig.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/overlays/vercel-eve/tsconfig.json
rename to templates/openui-self-hosted/overlays/vercel-eve/tsconfig.json
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/package-lock.json b/templates/openui-self-hosted/package-lock.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/package-lock.json
rename to templates/openui-self-hosted/package-lock.json
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/package.json b/templates/openui-self-hosted/package.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/package.json
rename to templates/openui-self-hosted/package.json
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/pnpm-workspace.yaml b/templates/openui-self-hosted/pnpm-workspace.yaml
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/pnpm-workspace.yaml
rename to templates/openui-self-hosted/pnpm-workspace.yaml
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/src/app/api/chat/route.ts b/templates/openui-self-hosted/src/app/api/chat/route.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/src/app/api/chat/route.ts
rename to templates/openui-self-hosted/src/app/api/chat/route.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/src/app/globals.css b/templates/openui-self-hosted/src/app/globals.css
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/src/app/globals.css
rename to templates/openui-self-hosted/src/app/globals.css
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/src/app/icon.svg b/templates/openui-self-hosted/src/app/icon.svg
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/src/app/icon.svg
rename to templates/openui-self-hosted/src/app/icon.svg
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/src/app/layout.tsx b/templates/openui-self-hosted/src/app/layout.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/src/app/layout.tsx
rename to templates/openui-self-hosted/src/app/layout.tsx
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/src/app/page.tsx b/templates/openui-self-hosted/src/app/page.tsx
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/src/app/page.tsx
rename to templates/openui-self-hosted/src/app/page.tsx
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/src/generated/spec.json b/templates/openui-self-hosted/src/generated/spec.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/src/generated/spec.json
rename to templates/openui-self-hosted/src/generated/spec.json
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/src/lib/library.ts b/templates/openui-self-hosted/src/lib/library.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/src/lib/library.ts
rename to templates/openui-self-hosted/src/lib/library.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/src/lib/prompt-options.ts b/templates/openui-self-hosted/src/lib/prompt-options.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/src/lib/prompt-options.ts
rename to templates/openui-self-hosted/src/lib/prompt-options.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/src/lib/tools/get-weather.ts b/templates/openui-self-hosted/src/lib/tools/get-weather.ts
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/src/lib/tools/get-weather.ts
rename to templates/openui-self-hosted/src/lib/tools/get-weather.ts
diff --git a/packages/openui-cli/src/templates/openui-self-hosted/tsconfig.json b/templates/openui-self-hosted/tsconfig.json
similarity index 100%
rename from packages/openui-cli/src/templates/openui-self-hosted/tsconfig.json
rename to templates/openui-self-hosted/tsconfig.json
diff --git a/templates/templates.json b/templates/templates.json
new file mode 100644
index 000000000..143674d34
--- /dev/null
+++ b/templates/templates.json
@@ -0,0 +1,58 @@
+{
+ "templates": [
+ {
+ "name": "OpenUI Cloud",
+ "key": "openui-cloud",
+ "description": "Hosted models, managed conversation history, built-in tools, and ready-to-use reports and presentations. Recommended default for prototypes and evaluations.",
+ "overlays": [
+ {
+ "name": "Default — minimal SDK route",
+ "key": "default",
+ "description": "Minimal SDK route"
+ },
+ {
+ "name": "LangGraph",
+ "key": "langgraph",
+ "description": "LangGraph agent with the selected model backend"
+ },
+ {
+ "name": "Vercel AI SDK",
+ "key": "vercel-ai-sdk",
+ "description": "Vercel AI SDK agent with the selected model backend"
+ },
+ {
+ "name": "Vercel Eve",
+ "key": "vercel-eve",
+ "description": "Eve agent rendered through Agent Interface"
+ }
+ ]
+ },
+ {
+ "name": "OpenUI Self-hosted",
+ "key": "openui-self-hosted",
+ "description": "Bring your own OpenAI-compatible provider, AI route, and persistence. Available only via --template.",
+ "overlays": [
+ {
+ "name": "Default — minimal SDK route",
+ "key": "default",
+ "description": "Minimal SDK route"
+ },
+ {
+ "name": "LangGraph",
+ "key": "langgraph",
+ "description": "LangGraph agent with the selected model backend"
+ },
+ {
+ "name": "Vercel AI SDK",
+ "key": "vercel-ai-sdk",
+ "description": "Vercel AI SDK agent with the selected model backend"
+ },
+ {
+ "name": "Vercel Eve",
+ "key": "vercel-eve",
+ "description": "Eve agent rendered through Agent Interface"
+ }
+ ]
+ }
+ ]
+}