create-better-t-stack 3.19.4 → 3.19.5-pr874.b75f803

package/dist/{src-mMd-eO_p.mjs → src-D_4oe5H9.mjs}

@@ -1,25 +1,25 @@
 #!/usr/bin/env node
 import { t as __reExport } from "./chunk-CHc3S52W.mjs";
-import { autocompleteMultiselect, cancel, confirm, group, intro, isCancel, log, multiselect, outro, select, spinner, text } from "@clack/prompts";
 import { createRouterClient, os } from "@orpc/server";
 import { Result, Result as Result$1, TaggedError } from "better-result";
-import pc from "picocolors";
 import { createCli } from "trpc-cli";
 import z from "zod";
-import { EMBEDDED_TEMPLATES, EMBEDDED_TEMPLATES as EMBEDDED_TEMPLATES$1, GeneratorError, GeneratorError as GeneratorError$1, TEMPLATE_COUNT, VirtualFileSystem, VirtualFileSystem as VirtualFileSystem$1, dependencyVersionMap, generate, generate as generate$1, generateReproducibleCommand, processAddonTemplates, processAddonsDeps } from "@better-t-stack/template-generator";
-import { writeTree } from "@better-t-stack/template-generator/fs-writer";
+import { autocompleteMultiselect, cancel, confirm, group, intro, isCancel, log, multiselect, outro, select, spinner, text } from "@clack/prompts";
+import pc from "picocolors";
+import envPaths from "env-paths";
 import fs from "fs-extra";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { EMBEDDED_TEMPLATES, EMBEDDED_TEMPLATES as EMBEDDED_TEMPLATES$1, GeneratorError, GeneratorError as GeneratorError$1, TEMPLATE_COUNT, VirtualFileSystem, VirtualFileSystem as VirtualFileSystem$1, dependencyVersionMap, generate, generate as generate$1, generateReproducibleCommand, processAddonTemplates, processAddonsDeps } from "@better-t-stack/template-generator";
 import consola, { consola as consola$1 } from "consola";
+import gradient from "gradient-string";
+import { $, execa } from "execa";
+import { writeTree } from "@better-t-stack/template-generator/fs-writer";
 import { ConfirmPrompt, GroupMultiSelectPrompt, MultiSelectPrompt, SelectPrompt, isCancel as isCancel$1 } from "@clack/core";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { applyEdits, modify, parse } from "jsonc-parser";
-import gradient from "gradient-string";
-import { $, execa } from "execa";
-import envPaths from "env-paths";
-import { format } from "oxfmt";
 import os$1 from "node:os";
+import { format } from "oxfmt";
 
 //#region src/utils/get-package-manager.ts
 const getUserPkgManager = () => {
@@ -86,6 +86,7 @@ const ADDON_COMPATIBILITY = {
 	starlight: [],
 	ultracite: [],
 	ruler: [],
+	mcp: [],
 	oxlint: [],
 	fumadocs: [],
 	opentui: [],
@@ -94,25 +95,6 @@ const ADDON_COMPATIBILITY = {
 	none: []
 };
 
-//#endregion
-//#region src/types.ts
-var types_exports = {};
-import * as import__better_t_stack_types from "@better-t-stack/types";
-__reExport(types_exports, import__better_t_stack_types);
-
-//#endregion
-//#region src/utils/compatibility.ts
-const WEB_FRAMEWORKS = [
-	"tanstack-router",
-	"react-router",
-	"tanstack-start",
-	"next",
-	"nuxt",
-	"svelte",
-	"solid",
-	"astro"
-];
-
 //#endregion
 //#region src/utils/errors.ts
 /**
@@ -177,30 +159,368 @@ var AddonSetupError = class extends TaggedError("AddonSetupError")() {
 	constructor(args) {
 		super(args);
 	}
-};
-/**
-* Create a user cancelled error Result
-*/
-function userCancelled(message) {
-	return Result.err(new UserCancelledError({ message }));
+};
+/**
+* Create a user cancelled error Result
+*/
+function userCancelled(message) {
+	return Result.err(new UserCancelledError({ message }));
+}
+/**
+* Create a database setup error Result
+*/
+function databaseSetupError(provider, message, cause) {
+	return Result.err(new DatabaseSetupError({
+		provider,
+		message,
+		cause
+	}));
+}
+/**
+* Display an error to the user (for CLI mode)
+*/
+function displayError(error) {
+	if (UserCancelledError.is(error)) cancel(pc.red(error.message));
+	else consola.error(pc.red(error.message));
+}
+
+//#endregion
+//#region src/utils/get-latest-cli-version.ts
+function getLatestCLIVersionResult() {
+	const packageJsonPath = path.join(PKG_ROOT, "package.json");
+	return Result.try({
+		try: () => {
+			return fs.readJSONSync(packageJsonPath).version;
+		},
+		catch: (e) => new CLIError({
+			message: `Failed to read CLI version from package.json: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+}
+function getLatestCLIVersion() {
+	return getLatestCLIVersionResult().unwrapOr("1.0.0");
+}
+
+//#endregion
+//#region src/utils/project-history.ts
+const paths = envPaths("better-t-stack", { suffix: "" });
+const HISTORY_FILE = "history.json";
+var HistoryError = class extends TaggedError("HistoryError")() {};
+function getHistoryDir() {
+	return paths.data;
+}
+function getHistoryPath() {
+	return path.join(paths.data, HISTORY_FILE);
+}
+function generateId() {
+	return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+}
+function emptyHistory() {
+	return {
+		version: 1,
+		entries: []
+	};
+}
+async function ensureHistoryDir() {
+	return Result.tryPromise({
+		try: async () => {
+			await fs.ensureDir(getHistoryDir());
+		},
+		catch: (e) => new HistoryError({
+			message: `Failed to create history directory: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+}
+async function readHistory() {
+	const historyPath = getHistoryPath();
+	const existsResult = await Result.tryPromise({
+		try: async () => await fs.pathExists(historyPath),
+		catch: (e) => new HistoryError({
+			message: `Failed to check history file: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (existsResult.isErr()) return existsResult;
+	if (!existsResult.value) return Result.ok(emptyHistory());
+	const readResult = await Result.tryPromise({
+		try: async () => await fs.readJson(historyPath),
+		catch: (e) => new HistoryError({
+			message: `Failed to read history file: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (readResult.isErr()) return Result.ok(emptyHistory());
+	return Result.ok(readResult.value);
+}
+async function writeHistory(history) {
+	const ensureDirResult = await ensureHistoryDir();
+	if (ensureDirResult.isErr()) return ensureDirResult;
+	return Result.tryPromise({
+		try: async () => {
+			await fs.writeJson(getHistoryPath(), history, { spaces: 2 });
+		},
+		catch: (e) => new HistoryError({
+			message: `Failed to write history file: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+}
+async function addToHistory(config, reproducibleCommand) {
+	const historyResult = await readHistory();
+	if (historyResult.isErr()) return historyResult;
+	const history = historyResult.value;
+	const entry = {
+		id: generateId(),
+		projectName: config.projectName,
+		projectDir: config.projectDir,
+		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+		stack: {
+			frontend: config.frontend,
+			backend: config.backend,
+			database: config.database,
+			orm: config.orm,
+			runtime: config.runtime,
+			auth: config.auth,
+			payments: config.payments,
+			api: config.api,
+			addons: config.addons,
+			examples: config.examples,
+			dbSetup: config.dbSetup,
+			packageManager: config.packageManager
+		},
+		cliVersion: getLatestCLIVersion(),
+		reproducibleCommand
+	};
+	history.entries.unshift(entry);
+	if (history.entries.length > 100) history.entries = history.entries.slice(0, 100);
+	return await writeHistory(history);
+}
+async function getHistory(limit = 10) {
+	const historyResult = await readHistory();
+	if (historyResult.isErr()) return historyResult;
+	return Result.ok(historyResult.value.entries.slice(0, limit));
+}
+async function clearHistory() {
+	const historyPath = getHistoryPath();
+	return Result.tryPromise({
+		try: async () => {
+			if (await fs.pathExists(historyPath)) await fs.remove(historyPath);
+		},
+		catch: (e) => new HistoryError({
+			message: `Failed to clear history: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+}
+
+//#endregion
+//#region src/utils/render-title.ts
+const TITLE_TEXT = `
+ ██████╗ ███████╗████████╗████████╗███████╗██████╗
+ ██╔══██╗██╔════╝╚══██╔══╝╚══██╔══╝██╔════╝██╔══██╗
+ ██████╔╝█████╗     ██║      ██║   █████╗  ██████╔╝
+ ██╔══██╗██╔══╝     ██║      ██║   ██╔══╝  ██╔══██╗
+ ██████╔╝███████╗   ██║      ██║   ███████╗██║  ██║
+ ╚═════╝ ╚══════╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═╝
+
+ ████████╗    ███████╗████████╗ █████╗  ██████╗██╗  ██╗
+ ╚══██╔══╝    ██╔════╝╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝
+    ██║       ███████╗   ██║   ███████║██║     █████╔╝
+    ██║       ╚════██║   ██║   ██╔══██║██║     ██╔═██╗
+    ██║       ███████║   ██║   ██║  ██║╚██████╗██║  ██╗
+    ╚═╝       ╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝
+ `;
+const catppuccinTheme = {
+	pink: "#F5C2E7",
+	mauve: "#CBA6F7",
+	red: "#F38BA8",
+	maroon: "#E78284",
+	peach: "#FAB387",
+	yellow: "#F9E2AF",
+	green: "#A6E3A1",
+	teal: "#94E2D5",
+	sky: "#89DCEB",
+	sapphire: "#74C7EC",
+	lavender: "#B4BEFE"
+};
+const renderTitle = () => {
+	const terminalWidth = process.stdout.columns || 80;
+	const titleLines = TITLE_TEXT.split("\n");
+	if (terminalWidth < Math.max(...titleLines.map((line) => line.length))) console.log(gradient(Object.values(catppuccinTheme)).multiline(`Better T Stack`));
+	else console.log(gradient(Object.values(catppuccinTheme)).multiline(TITLE_TEXT));
+};
+
+//#endregion
+//#region src/commands/history.ts
+function formatStackSummary(entry) {
+	const parts = [];
+	if (entry.stack.frontend.length > 0 && !entry.stack.frontend.includes("none")) parts.push(entry.stack.frontend.join(", "));
+	if (entry.stack.backend && entry.stack.backend !== "none") parts.push(entry.stack.backend);
+	if (entry.stack.database && entry.stack.database !== "none") parts.push(entry.stack.database);
+	if (entry.stack.orm && entry.stack.orm !== "none") parts.push(entry.stack.orm);
+	return parts.length > 0 ? parts.join(" + ") : "minimal";
+}
+function formatDate(isoString) {
+	return new Date(isoString).toLocaleDateString("en-US", {
+		year: "numeric",
+		month: "short",
+		day: "numeric",
+		hour: "2-digit",
+		minute: "2-digit"
+	});
+}
+async function historyHandler(input) {
+	if (input.clear) {
+		const clearResult = await clearHistory();
+		if (clearResult.isErr()) {
+			log.warn(pc.yellow(clearResult.error.message));
+			return;
+		}
+		log.success(pc.green("Project history cleared."));
+		return;
+	}
+	const historyResult = await getHistory(input.limit);
+	if (historyResult.isErr()) {
+		log.warn(pc.yellow(historyResult.error.message));
+		return;
+	}
+	const entries = historyResult.value;
+	if (entries.length === 0) {
+		log.info(pc.dim("No projects in history yet."));
+		log.info(pc.dim("Create a project with: create-better-t-stack my-app"));
+		return;
+	}
+	if (input.json) {
+		console.log(JSON.stringify(entries, null, 2));
+		return;
+	}
+	renderTitle();
+	intro(pc.magenta(`Project History (${entries.length} entries)`));
+	for (const [index, entry] of entries.entries()) {
+		const num = pc.dim(`${index + 1}.`);
+		const name = pc.cyan(pc.bold(entry.projectName));
+		const stack = pc.dim(formatStackSummary(entry));
+		log.message(`${num} ${name}`);
+		log.message(`   ${pc.dim("Created:")} ${formatDate(entry.createdAt)}`);
+		log.message(`   ${pc.dim("Path:")} ${entry.projectDir}`);
+		log.message(`   ${pc.dim("Stack:")} ${stack}`);
+		log.message(`   ${pc.dim("Command:")} ${pc.dim(entry.reproducibleCommand)}`);
+		log.message("");
+	}
+}
+
+//#endregion
+//#region src/utils/open-url.ts
+async function openUrl(url) {
+	const platform = process.platform;
+	if (platform === "darwin") {
+		await $({ stdio: "ignore" })`open ${url}`;
+		return;
+	}
+	if (platform === "win32") {
+		const escapedUrl = url.replace(/&/g, "^&");
+		await $({ stdio: "ignore" })`cmd /c start "" ${escapedUrl}`;
+		return;
+	}
+	await $({ stdio: "ignore" })`xdg-open ${url}`;
+}
+
+//#endregion
+//#region src/utils/sponsors.ts
+const SPONSORS_JSON_URL = "https://sponsors.better-t-stack.dev/sponsors.json";
+async function fetchSponsors(url = SPONSORS_JSON_URL) {
+	const s = spinner();
+	s.start("Fetching sponsors…");
+	const response = await fetch(url);
+	if (!response.ok) {
+		s.stop(pc.red(`Failed to fetch sponsors: ${response.statusText}`));
+		throw new Error(`Failed to fetch sponsors: ${response.statusText}`);
+	}
+	const sponsors = await response.json();
+	s.stop("Sponsors fetched successfully!");
+	return sponsors;
+}
+function displaySponsors(sponsors) {
+	const { total_sponsors } = sponsors.summary;
+	if (total_sponsors === 0) {
+		log.info("No sponsors found. You can be the first one! ✨");
+		outro(pc.cyan("Visit https://github.com/sponsors/AmanVarshney01 to become a sponsor."));
+		return;
+	}
+	displaySponsorsBox(sponsors);
+	if (total_sponsors - sponsors.specialSponsors.length > 0) log.message(pc.blue(`+${total_sponsors - sponsors.specialSponsors.length} more amazing sponsors.\n`));
+	outro(pc.magenta("Visit https://github.com/sponsors/AmanVarshney01 to become a sponsor."));
 }
-/**
-* Create a database setup error Result
-*/
-function databaseSetupError(provider, message, cause) {
-	return Result.err(new DatabaseSetupError({
-		provider,
-		message,
-		cause
-	}));
+function displaySponsorsBox(sponsors) {
+	if (sponsors.specialSponsors.length === 0) return;
+	let output = `${pc.bold(pc.cyan("-> Special Sponsors"))}\n\n`;
+	sponsors.specialSponsors.forEach((sponsor, idx) => {
+		const displayName = sponsor.name ?? sponsor.githubId;
+		const tier = sponsor.tierName ? ` ${pc.yellow(`(${sponsor.tierName})`)}` : "";
+		output += `${pc.green(`• ${displayName}`)}${tier}\n`;
+		output += `  ${pc.dim("GitHub:")} https://github.com/${sponsor.githubId}\n`;
+		const website = sponsor.websiteUrl ?? sponsor.githubUrl;
+		if (website) output += `  ${pc.dim("Website:")} ${website}\n`;
+		if (idx < sponsors.specialSponsors.length - 1) output += "\n";
+	});
+	consola$1.box(output);
 }
-/**
-* Display an error to the user (for CLI mode)
-*/
-function displayError(error) {
-	if (UserCancelledError.is(error)) cancel(pc.red(error.message));
-	else consola.error(pc.red(error.message));
+
+//#endregion
+//#region src/commands/meta.ts
+const DOCS_URL = "https://better-t-stack.dev/docs";
+const BUILDER_URL = "https://better-t-stack.dev/new";
+async function openExternalUrl(url, successMessage) {
+	if ((await Result.tryPromise({
+		try: () => openUrl(url),
+		catch: () => null
+	})).isOk()) log.success(pc.blue(successMessage));
+	else log.message(`Please visit ${url}`);
+}
+async function showSponsorsCommand() {
+	const result = await Result.tryPromise({
+		try: async () => {
+			renderTitle();
+			intro(pc.magenta("Better-T-Stack Sponsors"));
+			displaySponsors(await fetchSponsors());
+		},
+		catch: (error) => new CLIError({
+			message: error instanceof Error ? error.message : "Failed to display sponsors",
+			cause: error
+		})
+	});
+	if (result.isErr()) {
+		displayError(result.error);
+		process.exit(1);
+	}
 }
+async function openDocsCommand() {
+	await openExternalUrl(DOCS_URL, "Opened docs in your default browser.");
+}
+async function openBuilderCommand() {
+	await openExternalUrl(BUILDER_URL, "Opened builder in your default browser.");
+}
+
+//#endregion
+//#region src/types.ts
+var types_exports = {};
+import * as import__better_t_stack_types from "@better-t-stack/types";
+__reExport(types_exports, import__better_t_stack_types);
+
+//#endregion
+//#region src/utils/compatibility.ts
+const WEB_FRAMEWORKS = [
+	"tanstack-router",
+	"react-router",
+	"tanstack-start",
+	"next",
+	"nuxt",
+	"svelte",
+	"solid",
+	"astro"
+];
 
 //#endregion
 //#region src/utils/compatibility-rules.ts
@@ -705,6 +1025,10 @@ function getAddonDisplay(addon) {
 			label = "Skills";
 			hint = "AI coding agent skills for your stack";
 			break;
+		case "mcp":
+			label = "MCP";
+			hint = "Install MCP servers (docs, databases, SaaS) via add-mcp";
+			break;
 		default:
 			label = addon;
 			hint = `Add ${addon}`;
@@ -730,7 +1054,11 @@ const ADDON_GROUPS = {
 		"opentui",
 		"wxt"
 	],
-	AI: ["ruler", "skills"]
+	AI: [
+		"ruler",
+		"skills",
+		"mcp"
+	]
 };
 async function getAddonsChoice(addons, frontends, auth) {
 	if (addons !== void 0) return addons;
@@ -845,43 +1173,6 @@ async function updateBtsConfig(projectDir, updates) {
 	} catch {}
 }
 
-//#endregion
-//#region src/utils/render-title.ts
-const TITLE_TEXT = `
- ██████╗ ███████╗████████╗████████╗███████╗██████╗
- ██╔══██╗██╔════╝╚══██╔══╝╚══██╔══╝██╔════╝██╔══██╗
- ██████╔╝█████╗     ██║      ██║   █████╗  ██████╔╝
- ██╔══██╗██╔══╝     ██║      ██║   ██╔══╝  ██╔══██╗
- ██████╔╝███████╗   ██║      ██║   ███████╗██║  ██║
- ╚═════╝ ╚══════╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═╝
-
- ████████╗    ███████╗████████╗ █████╗  ██████╗██╗  ██╗
- ╚══██╔══╝    ██╔════╝╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝
-    ██║       ███████╗   ██║   ███████║██║     █████╔╝
-    ██║       ╚════██║   ██║   ██╔══██║██║     ██╔═██╗
-    ██║       ███████║   ██║   ██║  ██║╚██████╗██║  ██╗
-    ╚═╝       ╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝
- `;
-const catppuccinTheme = {
-	pink: "#F5C2E7",
-	mauve: "#CBA6F7",
-	red: "#F38BA8",
-	maroon: "#E78284",
-	peach: "#FAB387",
-	yellow: "#F9E2AF",
-	green: "#A6E3A1",
-	teal: "#94E2D5",
-	sky: "#89DCEB",
-	sapphire: "#74C7EC",
-	lavender: "#B4BEFE"
-};
-const renderTitle = () => {
-	const terminalWidth = process.stdout.columns || 80;
-	const titleLines = TITLE_TEXT.split("\n");
-	if (terminalWidth < Math.max(...titleLines.map((line) => line.length))) console.log(gradient(Object.values(catppuccinTheme)).multiline(`Better T Stack`));
-	else console.log(gradient(Object.values(catppuccinTheme)).multiline(TITLE_TEXT));
-};
-
 //#endregion
 //#region src/utils/add-package-deps.ts
 const addPackageDependency = async (opts) => {
@@ -1102,6 +1393,248 @@ async function setupFumadocs(config) {
 	return Result.ok(void 0);
 }
 
+//#endregion
+//#region src/helpers/addons/mcp-setup.ts
+const MCP_AGENTS = [
+	{
+		value: "cursor",
+		label: "Cursor",
+		scope: "both"
+	},
+	{
+		value: "claude-code",
+		label: "Claude Code",
+		scope: "both"
+	},
+	{
+		value: "codex",
+		label: "Codex",
+		scope: "both"
+	},
+	{
+		value: "opencode",
+		label: "OpenCode",
+		scope: "both"
+	},
+	{
+		value: "gemini-cli",
+		label: "Gemini CLI",
+		scope: "both"
+	},
+	{
+		value: "vscode",
+		label: "VS Code (GitHub Copilot)",
+		scope: "both"
+	},
+	{
+		value: "zed",
+		label: "Zed",
+		scope: "both"
+	},
+	{
+		value: "claude-desktop",
+		label: "Claude Desktop",
+		scope: "global"
+	},
+	{
+		value: "goose",
+		label: "Goose",
+		scope: "global"
+	}
+];
+function uniqueValues$1(values) {
+	return Array.from(new Set(values));
+}
+function hasReactBasedFrontend$1(frontend) {
+	return frontend.includes("react-router") || frontend.includes("tanstack-router") || frontend.includes("tanstack-start") || frontend.includes("next");
+}
+function getPackageRunnerWithYesFlag(packageManager) {
+	const prefix = getPackageRunnerPrefix(packageManager);
+	const runner = prefix[0];
+	if (runner === "bunx") return [...prefix, "-y"];
+	if (runner === "npx") return [...prefix, "-y"];
+	if (runner === "pnpm") return [...prefix, "--yes"];
+	return prefix;
+}
+function getRecommendedMcpServers(config) {
+	const servers = [];
+	servers.push({
+		key: "context7",
+		label: "Context7",
+		name: "context7",
+		target: "@upstash/context7-mcp"
+	});
+	if (config.runtime === "workers" || config.webDeploy === "cloudflare" || config.serverDeploy === "cloudflare") servers.push({
+		key: "cloudflare-docs",
+		label: "Cloudflare Docs",
+		name: "cloudflare-docs",
+		target: "https://docs.mcp.cloudflare.com/sse",
+		transport: "sse"
+	});
+	if (config.backend === "convex") servers.push({
+		key: "convex",
+		label: "Convex",
+		name: "convex",
+		target: "npx -y convex@latest mcp start"
+	});
+	if (hasReactBasedFrontend$1(config.frontend)) servers.push({
+		key: "shadcn",
+		label: "shadcn/ui",
+		name: "shadcn",
+		target: "npx -y shadcn@latest mcp"
+	});
+	if (config.frontend.includes("next")) servers.push({
+		key: "next-devtools",
+		label: "Next Devtools",
+		name: "next-devtools",
+		target: "npx -y next-devtools-mcp@latest"
+	});
+	if (config.frontend.includes("nuxt")) servers.push({
+		key: "nuxt-docs",
+		label: "Nuxt Docs",
+		name: "nuxt",
+		target: "https://nuxt.com/mcp"
+	}, {
+		key: "nuxt-ui-docs",
+		label: "Nuxt UI Docs",
+		name: "nuxt-ui",
+		target: "https://ui.nuxt.com/mcp"
+	});
+	if (config.frontend.includes("svelte")) servers.push({
+		key: "svelte-docs",
+		label: "Svelte Docs",
+		name: "svelte",
+		target: "https://mcp.svelte.dev/mcp"
+	});
+	if (config.frontend.includes("astro")) servers.push({
+		key: "astro-docs",
+		label: "Astro Docs",
+		name: "astro-docs",
+		target: "https://mcp.docs.astro.build/mcp"
+	});
+	if (config.dbSetup === "planetscale") servers.push({
+		key: "planetscale",
+		label: "PlanetScale",
+		name: "planetscale",
+		target: "https://mcp.pscale.dev/mcp/planetscale"
+	});
+	if (config.dbSetup === "neon") servers.push({
+		key: "neon",
+		label: "Neon",
+		name: "neon",
+		target: "https://mcp.neon.tech/mcp"
+	});
+	if (config.dbSetup === "supabase") servers.push({
+		key: "supabase",
+		label: "Supabase",
+		name: "supabase",
+		target: "https://mcp.supabase.com/mcp"
+	});
+	if (config.auth === "better-auth") servers.push({
+		key: "better-auth",
+		label: "Better Auth",
+		name: "better-auth",
+		target: "https://mcp.inkeep.com/better-auth/mcp"
+	});
+	return servers;
+}
+function filterAgentsForScope(scope) {
+	return MCP_AGENTS.filter((a) => a.scope === "both" || a.scope === scope);
+}
+async function setupMcp(config) {
+	if (shouldSkipExternalCommands()) return Result.ok(void 0);
+	const { packageManager, projectDir } = config;
+	log.info("Setting up MCP servers...");
+	const scope = await select({
+		message: "Where should MCP servers be installed?",
+		options: [{
+			value: "project",
+			label: "Project",
+			hint: "Writes to project config files (recommended for teams)"
+		}, {
+			value: "global",
+			label: "Global",
+			hint: "Writes to user-level config files (personal machine)"
+		}],
+		initialValue: "project"
+	});
+	if (isCancel(scope)) return Result.err(new UserCancelledError({ message: "Operation cancelled" }));
+	const recommendedServers = getRecommendedMcpServers(config);
+	if (recommendedServers.length === 0) return Result.ok(void 0);
+	const serverOptions = recommendedServers.map((s) => ({
+		value: s.key,
+		label: s.label,
+		hint: s.target
+	}));
+	const selectedServerKeys = await multiselect({
+		message: "Select MCP servers to install",
+		options: serverOptions,
+		required: false,
+		initialValues: serverOptions.map((o) => o.value)
+	});
+	if (isCancel(selectedServerKeys)) return Result.err(new UserCancelledError({ message: "Operation cancelled" }));
+	if (selectedServerKeys.length === 0) return Result.ok(void 0);
+	const agentOptions = filterAgentsForScope(scope).map((a) => ({
+		value: a.value,
+		label: a.label
+	}));
+	const selectedAgents = await multiselect({
+		message: "Select agents to install MCP servers to",
+		options: agentOptions,
+		required: false,
+		initialValues: uniqueValues$1([
+			"cursor",
+			"claude-code",
+			"vscode"
+		].filter((a) => agentOptions.some((o) => o.value === a)))
+	});
+	if (isCancel(selectedAgents)) return Result.err(new UserCancelledError({ message: "Operation cancelled" }));
+	if (selectedAgents.length === 0) return Result.ok(void 0);
+	const serversByKey = new Map(recommendedServers.map((s) => [s.key, s]));
+	const selectedServers = [];
+	for (const key of selectedServerKeys) {
+		const server = serversByKey.get(key);
+		if (server) selectedServers.push(server);
+	}
+	if (selectedServers.length === 0) return Result.ok(void 0);
+	const installSpinner = spinner();
+	installSpinner.start("Installing MCP servers...");
+	const runner = getPackageRunnerWithYesFlag(packageManager);
+	const globalFlags = scope === "global" ? ["-g"] : [];
+	for (const server of selectedServers) {
+		const transportFlags = server.transport ? ["-t", server.transport] : [];
+		const headerFlags = (server.headers ?? []).flatMap((h) => ["--header", h]);
+		const agentFlags = selectedAgents.flatMap((a) => ["-a", a]);
+		const args = [
+			...runner,
+			"add-mcp@latest",
+			server.target,
+			"--name",
+			server.name,
+			...transportFlags,
+			...headerFlags,
+			...agentFlags,
+			...globalFlags,
+			"-y"
+		];
+		if ((await Result.tryPromise({
+			try: async () => {
+				await $({
+					cwd: projectDir,
+					env: { CI: "true" }
+				})`${args}`;
+			},
+			catch: (e) => new AddonSetupError({
+				addon: "mcp",
+				message: `Failed to install MCP server '${server.name}': ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			})
+		})).isErr()) log.warn(pc.yellow(`Warning: Could not install MCP server '${server.name}'`));
+	}
+	installSpinner.stop("MCP servers installed");
+	return Result.ok(void 0);
+}
+
 //#endregion
 //#region src/helpers/addons/oxlint-setup.ts
 async function setupOxlint(projectDir, packageManager) {
@@ -1250,58 +1783,20 @@ async function addRulerScriptToPackageJson(projectDir, packageManager) {
 //#endregion
 //#region src/helpers/addons/skills-setup.ts
 const SKILL_SOURCES = {
-	"vercel-labs/agent-skills": {
-		source: "vercel-labs/agent-skills",
-		label: "Vercel Agent Skills"
-	},
-	"vercel/ai": {
-		source: "vercel/ai",
-		label: "Vercel AI SDK"
-	},
-	"vercel/turborepo": {
-		source: "vercel/turborepo",
-		label: "Turborepo"
-	},
-	"yusukebe/hono-skill": {
-		source: "yusukebe/hono-skill",
-		label: "Hono Backend"
-	},
-	"vercel-labs/next-skills": {
-		source: "vercel-labs/next-skills",
-		label: "Next.js Best Practices"
-	},
-	"heroui-inc/heroui": {
-		source: "heroui-inc/heroui",
-		label: "HeroUI Native"
-	},
-	"better-auth/skills": {
-		source: "better-auth/skills",
-		label: "Better Auth"
-	},
-	"neondatabase/agent-skills": {
-		source: "neondatabase/agent-skills",
-		label: "Neon Database"
-	},
-	"supabase/agent-skills": {
-		source: "supabase/agent-skills",
-		label: "Supabase"
-	},
-	"expo/skills": {
-		source: "expo/skills",
-		label: "Expo"
-	},
-	"prisma/skills": {
-		source: "prisma/skills",
-		label: "Prisma"
-	},
-	"elysiajs/skills": {
-		source: "elysiajs/skills",
-		label: "ElysiaJS"
-	},
-	"waynesutton/convexskills": {
-		source: "waynesutton/convexskills",
-		label: "Convex"
-	}
+	"vercel-labs/agent-skills": { label: "Vercel Agent Skills" },
+	"vercel/ai": { label: "Vercel AI SDK" },
+	"vercel/turborepo": { label: "Turborepo" },
+	"yusukebe/hono-skill": { label: "Hono Backend" },
+	"vercel-labs/next-skills": { label: "Next.js Best Practices" },
+	"nuxt/ui": { label: "Nuxt UI" },
+	"heroui-inc/heroui": { label: "HeroUI Native" },
+	"better-auth/skills": { label: "Better Auth" },
+	"neondatabase/agent-skills": { label: "Neon Database" },
+	"supabase/agent-skills": { label: "Supabase" },
+	"expo/skills": { label: "Expo" },
+	"prisma/skills": { label: "Prisma" },
+	"elysiajs/skills": { label: "ElysiaJS" },
+	"waynesutton/convexskills": { label: "Convex" }
 };
 const AVAILABLE_AGENTS = [
 	{
@@ -1405,19 +1900,24 @@ const AVAILABLE_AGENTS = [
 		label: "MCPJam"
 	}
 ];
+function hasReactBasedFrontend(frontend) {
+	return frontend.includes("react-router") || frontend.includes("tanstack-router") || frontend.includes("tanstack-start") || frontend.includes("next");
+}
+function hasNativeFrontend(frontend) {
+	return frontend.includes("native-bare") || frontend.includes("native-uniwind") || frontend.includes("native-unistyles");
+}
 function getRecommendedSourceKeys(config) {
 	const sources = [];
 	const { frontend, backend, dbSetup, auth, examples, addons, orm } = config;
-	const hasReactBasedFrontend = frontend.includes("react-router") || frontend.includes("tanstack-router") || frontend.includes("tanstack-start") || frontend.includes("next");
-	const hasNativeFrontend = frontend.includes("native-bare") || frontend.includes("native-uniwind") || frontend.includes("native-unistyles");
-	if (hasReactBasedFrontend) sources.push("vercel-labs/agent-skills");
+	if (hasReactBasedFrontend(frontend)) sources.push("vercel-labs/agent-skills");
 	if (frontend.includes("next")) sources.push("vercel-labs/next-skills");
+	if (frontend.includes("nuxt")) sources.push("nuxt/ui");
 	if (frontend.includes("native-uniwind")) sources.push("heroui-inc/heroui");
-	if (hasNativeFrontend) sources.push("expo/skills");
+	if (hasNativeFrontend(frontend)) sources.push("expo/skills");
 	if (auth === "better-auth") sources.push("better-auth/skills");
 	if (dbSetup === "neon") sources.push("neondatabase/agent-skills");
 	if (dbSetup === "supabase") sources.push("supabase/agent-skills");
-	if (orm === "prisma") sources.push("prisma/skills");
+	if (orm === "prisma" || dbSetup === "prisma-postgres") sources.push("prisma/skills");
 	if (examples.includes("ai")) sources.push("vercel/ai");
 	if (addons.includes("turborepo")) sources.push("vercel/turborepo");
 	if (backend === "hono") sources.push("yusukebe/hono-skill");
@@ -1425,60 +1925,95 @@ function getRecommendedSourceKeys(config) {
 	if (backend === "convex") sources.push("waynesutton/convexskills");
 	return sources;
 }
-function parseSkillsFromOutput(output) {
-	const skills = [];
-	const lines = output.split("\n");
-	const ansiRegex = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
-	for (const line of lines) {
-		const match = line.replace(ansiRegex, "").match(/^│\s{4}([a-z][a-z0-9-]*)$/);
-		if (match) skills.push(match[1]);
-	}
-	return skills;
+const CURATED_SKILLS_BY_SOURCE = {
+	"vercel-labs/agent-skills": (config) => {
+		const skills = [
+			"web-design-guidelines",
+			"vercel-composition-patterns",
+			"vercel-react-best-practices"
+		];
+		if (hasNativeFrontend(config.frontend)) skills.push("vercel-react-native-skills");
+		return skills;
+	},
+	"vercel/ai": () => ["ai-sdk"],
+	"vercel/turborepo": () => ["turborepo"],
+	"yusukebe/hono-skill": () => ["hono"],
+	"vercel-labs/next-skills": () => ["next-best-practices", "next-cache-components"],
+	"nuxt/ui": () => ["nuxt-ui"],
+	"heroui-inc/heroui": () => ["heroui-native"],
+	"better-auth/skills": () => ["better-auth-best-practices"],
+	"neondatabase/agent-skills": () => ["neon-postgres"],
+	"supabase/agent-skills": () => ["supabase-postgres-best-practices"],
+	"expo/skills": (config) => {
+		const skills = [
+			"expo-dev-client",
+			"building-native-ui",
+			"native-data-fetching",
+			"expo-deployment",
+			"upgrading-expo",
+			"expo-cicd-workflows"
+		];
+		if (config.frontend.includes("native-uniwind")) skills.push("expo-tailwind-setup");
+		return skills;
+	},
+	"prisma/skills": (config) => {
+		const skills = [];
+		if (config.orm === "prisma") skills.push("prisma-cli", "prisma-client-api", "prisma-database-setup");
+		if (config.dbSetup === "prisma-postgres") skills.push("prisma-postgres");
+		return skills;
+	},
+	"elysiajs/skills": () => ["elysiajs"],
+	"waynesutton/convexskills": () => [
+		"convex-best-practices",
+		"convex-functions",
+		"convex-schema-validator",
+		"convex-realtime",
+		"convex-http-actions",
+		"convex-cron-jobs",
+		"convex-file-storage",
+		"convex-migrations",
+		"convex-security-check"
+	]
+};
+function getCuratedSkillNamesForSourceKey(sourceKey, config) {
+	return CURATED_SKILLS_BY_SOURCE[sourceKey](config);
 }
 function uniqueValues(values) {
 	return Array.from(new Set(values));
 }
-async function fetchSkillsFromSource(source, packageManager, projectDir) {
-	try {
-		const args = getPackageExecutionArgs(packageManager, `skills@latest add ${source.source} --list`);
-		return parseSkillsFromOutput((await $({
-			cwd: projectDir,
-			env: { CI: "true" }
-		})`${args}`).stdout);
-	} catch {
-		return [];
-	}
-}
 async function setupSkills(config) {
 	if (shouldSkipExternalCommands()) return Result.ok(void 0);
 	const { packageManager, projectDir } = config;
 	const btsConfig = await readBtsConfig(projectDir);
-	const recommendedSourceKeys = getRecommendedSourceKeys(btsConfig ? {
+	const fullConfig = btsConfig ? {
 		...config,
 		addons: btsConfig.addons ?? config.addons
-	} : config);
+	} : config;
+	const recommendedSourceKeys = getRecommendedSourceKeys(fullConfig);
 	if (recommendedSourceKeys.length === 0) return Result.ok(void 0);
-	const sourceKeys = uniqueValues(recommendedSourceKeys);
-	const s = spinner();
-	s.start("Fetching available skills...");
-	const allSkills = [];
-	const sources = sourceKeys.map((sourceKey) => SKILL_SOURCES[sourceKey]).filter((source) => Boolean(source));
-	const fetchedSkills = await Promise.all(sources.map(async (source) => ({
-		source,
-		skills: await fetchSkillsFromSource(source, packageManager, projectDir)
-	})));
-	for (const { source, skills } of fetchedSkills) for (const skillName of skills) allSkills.push({
-		name: skillName,
-		source: source.source,
-		sourceLabel: source.label
-	});
-	s.stop("Fetched available skills");
-	if (allSkills.length === 0) return Result.ok(void 0);
-	const skillOptions = allSkills.map((skill) => ({
-		value: `${skill.source}::${skill.name}`,
-		label: skill.name,
-		hint: skill.sourceLabel
-	}));
+	const skillOptions = uniqueValues(recommendedSourceKeys).flatMap((sourceKey) => {
+		const source = SKILL_SOURCES[sourceKey];
+		return getCuratedSkillNamesForSourceKey(sourceKey, fullConfig).map((skillName) => ({
+			value: `${sourceKey}::${skillName}`,
+			label: skillName,
+			hint: source.label
+		}));
+	});
+	if (skillOptions.length === 0) return Result.ok(void 0);
+	const scope = await select({
+		message: "Where should skills be installed?",
+		options: [{
+			value: "project",
+			label: "Project",
+			hint: "Writes to project config files (recommended for teams)"
+		}, {
+			value: "global",
+			label: "Global",
+			hint: "Writes to user-level config files (personal machine)"
+		}],
+		initialValue: "project"
+	});
+	if (isCancel(scope)) return Result.err(new UserCancelledError({ message: "Operation cancelled" }));
 	const selectedSkills = await multiselect({
 		message: "Select skills to install",
 		options: skillOptions,
@@ -1508,11 +2043,12 @@ async function setupSkills(config) {
 	const installSpinner = spinner();
 	installSpinner.start("Installing skills...");
 	const agentFlags = selectedAgents.map((a) => `-a ${a}`).join(" ");
+	const globalFlag = scope === "global" ? "-g" : "";
 	for (const [source, skills] of Object.entries(skillsBySource)) {
 		const skillFlags = skills.map((s) => `-s ${s}`).join(" ");
 		if ((await Result.tryPromise({
 			try: async () => {
-				const args = getPackageExecutionArgs(packageManager, `skills@latest add ${source} ${skillFlags} ${agentFlags} -y`);
+				const args = getPackageExecutionArgs(packageManager, `skills@latest add ${source} ${globalFlag} ${skillFlags} ${agentFlags} -y`);
 				await $({
 					cwd: projectDir,
 					env: { CI: "true" }
@@ -2012,6 +2548,7 @@ async function setupAddons(config) {
 	if (addons.includes("wxt")) await runSetup(() => setupWxt(config));
 	if (addons.includes("ruler")) await runSetup(() => setupRuler(config));
 	if (addons.includes("skills")) await runSetup(() => setupSkills(config));
+	if (addons.includes("mcp")) await runSetup(() => setupMcp(config));
 }
 async function setupBiome(projectDir) {
 	await addPackageDependency({
@@ -3026,37 +3563,19 @@ async function getProjectName(initialName) {
 			initialValue: initialName,
 			defaultValue: defaultName,
 			validate: (value) => {
-				const nameToUse = String(value ?? "").trim() || defaultName;
-				const validationError = validateDirectoryName(path.basename(nameToUse));
-				if (validationError) return validationError;
-				if (nameToUse !== ".") {
-					if (!isPathWithinCwd$1(path.resolve(process.cwd(), nameToUse))) return "Project path must be within current directory";
-				}
-			}
-		});
-		if (isCancel(response)) throw new UserCancelledError({ message: "Operation cancelled." });
-		projectPath = response || defaultName;
-		isValid = true;
-	}
-	return projectPath;
-}
-
-//#endregion
-//#region src/utils/get-latest-cli-version.ts
-function getLatestCLIVersionResult() {
-	const packageJsonPath = path.join(PKG_ROOT, "package.json");
-	return Result.try({
-		try: () => {
-			return fs.readJSONSync(packageJsonPath).version;
-		},
-		catch: (e) => new CLIError({
-			message: `Failed to read CLI version from package.json: ${e instanceof Error ? e.message : String(e)}`,
-			cause: e
-		})
-	});
-}
-function getLatestCLIVersion() {
-	return getLatestCLIVersionResult().unwrapOr("1.0.0");
+				const nameToUse = String(value ?? "").trim() || defaultName;
+				const validationError = validateDirectoryName(path.basename(nameToUse));
+				if (validationError) return validationError;
+				if (nameToUse !== ".") {
+					if (!isPathWithinCwd$1(path.resolve(process.cwd(), nameToUse))) return "Project path must be within current directory";
+				}
+			}
+		});
+		if (isCancel(response)) throw new UserCancelledError({ message: "Operation cancelled." });
+		projectPath = response || defaultName;
+		isValid = true;
+	}
+	return projectPath;
 }
 
 //#endregion
@@ -3069,7 +3588,7 @@ function getLatestCLIVersion() {
 */
 function isTelemetryEnabled() {
 	const BTS_TELEMETRY_DISABLED = process.env.BTS_TELEMETRY_DISABLED;
-	const BTS_TELEMETRY = "1";
+	const BTS_TELEMETRY = "0";
 	if (BTS_TELEMETRY_DISABLED !== void 0) return BTS_TELEMETRY_DISABLED !== "1";
 	if (BTS_TELEMETRY !== void 0) return BTS_TELEMETRY === "1";
 	return true;
@@ -3077,17 +3596,7 @@ function isTelemetryEnabled() {
 
 //#endregion
 //#region src/utils/analytics.ts
-const CONVEX_INGEST_URL = "https://striped-seahorse-863.convex.site/api/analytics/ingest";
-async function sendConvexEvent(payload) {
-	await Result.tryPromise({
-		try: () => fetch(CONVEX_INGEST_URL, {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify(payload)
-		}),
-		catch: () => void 0
-	});
-}
+async function sendConvexEvent(payload) {}
 async function trackProjectCreation(config, disableAnalytics = false) {
 	if (!isTelemetryEnabled() || disableAnalytics) return;
 	const { projectName: _projectName, projectDir: _projectDir, relativePath: _relativePath, ...safeConfig } = config;
@@ -3233,119 +3742,6 @@ async function setupProjectDirectory(finalPathInput, shouldClearDirectory) {
 	};
 }
 
-//#endregion
-//#region src/utils/project-history.ts
-const paths = envPaths("better-t-stack", { suffix: "" });
-const HISTORY_FILE = "history.json";
-var HistoryError = class extends TaggedError("HistoryError")() {};
-function getHistoryDir() {
-	return paths.data;
-}
-function getHistoryPath() {
-	return path.join(paths.data, HISTORY_FILE);
-}
-function generateId() {
-	return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-}
-function emptyHistory() {
-	return {
-		version: 1,
-		entries: []
-	};
-}
-async function ensureHistoryDir() {
-	return Result.tryPromise({
-		try: async () => {
-			await fs.ensureDir(getHistoryDir());
-		},
-		catch: (e) => new HistoryError({
-			message: `Failed to create history directory: ${e instanceof Error ? e.message : String(e)}`,
-			cause: e
-		})
-	});
-}
-async function readHistory() {
-	const historyPath = getHistoryPath();
-	const existsResult = await Result.tryPromise({
-		try: async () => await fs.pathExists(historyPath),
-		catch: (e) => new HistoryError({
-			message: `Failed to check history file: ${e instanceof Error ? e.message : String(e)}`,
-			cause: e
-		})
-	});
-	if (existsResult.isErr()) return existsResult;
-	if (!existsResult.value) return Result.ok(emptyHistory());
-	const readResult = await Result.tryPromise({
-		try: async () => await fs.readJson(historyPath),
-		catch: (e) => new HistoryError({
-			message: `Failed to read history file: ${e instanceof Error ? e.message : String(e)}`,
-			cause: e
-		})
-	});
-	if (readResult.isErr()) return Result.ok(emptyHistory());
-	return Result.ok(readResult.value);
-}
-async function writeHistory(history) {
-	const ensureDirResult = await ensureHistoryDir();
-	if (ensureDirResult.isErr()) return ensureDirResult;
-	return Result.tryPromise({
-		try: async () => {
-			await fs.writeJson(getHistoryPath(), history, { spaces: 2 });
-		},
-		catch: (e) => new HistoryError({
-			message: `Failed to write history file: ${e instanceof Error ? e.message : String(e)}`,
-			cause: e
-		})
-	});
-}
-async function addToHistory(config, reproducibleCommand) {
-	const historyResult = await readHistory();
-	if (historyResult.isErr()) return historyResult;
-	const history = historyResult.value;
-	const entry = {
-		id: generateId(),
-		projectName: config.projectName,
-		projectDir: config.projectDir,
-		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-		stack: {
-			frontend: config.frontend,
-			backend: config.backend,
-			database: config.database,
-			orm: config.orm,
-			runtime: config.runtime,
-			auth: config.auth,
-			payments: config.payments,
-			api: config.api,
-			addons: config.addons,
-			examples: config.examples,
-			dbSetup: config.dbSetup,
-			packageManager: config.packageManager
-		},
-		cliVersion: getLatestCLIVersion(),
-		reproducibleCommand
-	};
-	history.entries.unshift(entry);
-	if (history.entries.length > 100) history.entries = history.entries.slice(0, 100);
-	return await writeHistory(history);
-}
-async function getHistory(limit = 10) {
-	const historyResult = await readHistory();
-	if (historyResult.isErr()) return historyResult;
-	return Result.ok(historyResult.value.entries.slice(0, limit));
-}
-async function clearHistory() {
-	const historyPath = getHistoryPath();
-	return Result.tryPromise({
-		try: async () => {
-			if (await fs.pathExists(historyPath)) await fs.remove(historyPath);
-		},
-		catch: (e) => new HistoryError({
-			message: `Failed to clear history: ${e instanceof Error ? e.message : String(e)}`,
-			cause: e
-		})
-	});
-}
-
 //#endregion
 //#region src/utils/project-name-validation.ts
 function validateProjectName(name) {
@@ -5072,11 +5468,12 @@ async function displayPostInstallInstructions(config) {
 		"solid"
 	].includes(f));
 	const hasNative = frontend?.includes("native-bare") || frontend?.includes("native-uniwind") || frontend?.includes("native-unistyles");
-	const bunWebNativeWarning = packageManager === "bun" && hasNative && hasWeb ? getBunWebNativeWarning() : "";
-	const noOrmWarning = !isConvex && database !== "none" && orm === "none" ? getNoOrmWarning() : "";
 	const hasReactRouter = frontend?.includes("react-router");
 	const hasSvelte = frontend?.includes("svelte");
 	const webPort = hasReactRouter || hasSvelte ? "5173" : "3001";
+	const betterAuthConvexInstructions = isConvex && config.auth === "better-auth" ? getBetterAuthConvexInstructions(hasWeb ?? false, webPort, packageManager) : "";
+	const bunWebNativeWarning = packageManager === "bun" && hasNative && hasWeb ? getBunWebNativeWarning() : "";
+	const noOrmWarning = !isConvex && database !== "none" && orm === "none" ? getNoOrmWarning() : "";
 	let output = `${pc.bold("Next steps")}\n${pc.cyan("1.")} ${cdCmd}\n`;
 	let stepCounter = 2;
 	if (!depsInstalled) output += `${pc.cyan(`${stepCounter++}.`)} ${packageManager} install\n`;
@@ -5116,6 +5513,7 @@ async function displayPostInstallInstructions(config) {
 	if (alchemyDeployInstructions) output += `\n${alchemyDeployInstructions.trim()}\n`;
 	if (starlightInstructions) output += `\n${starlightInstructions.trim()}\n`;
 	if (clerkInstructions) output += `\n${clerkInstructions.trim()}\n`;
+	if (betterAuthConvexInstructions) output += `\n${betterAuthConvexInstructions.trim()}\n`;
 	if (polarInstructions) output += `\n${polarInstructions.trim()}\n`;
 	if (noOrmWarning) output += `\n${noOrmWarning.trim()}\n`;
 	if (bunWebNativeWarning) output += `\n${bunWebNativeWarning.trim()}\n`;
@@ -5199,6 +5597,10 @@ function getBunWebNativeWarning() {
 function getClerkInstructions() {
 	return `${pc.bold("Clerk Authentication Setup:")}\n${pc.cyan("•")} Follow the guide: ${pc.underline("https://docs.convex.dev/auth/clerk")}\n${pc.cyan("•")} Set CLERK_JWT_ISSUER_DOMAIN in Convex Dashboard\n${pc.cyan("•")} Set CLERK_PUBLISHABLE_KEY in apps/*/.env`;
 }
+function getBetterAuthConvexInstructions(hasWeb, webPort, packageManager) {
+	const cmd = packageManager === "npm" ? "npx" : packageManager;
+	return `${pc.bold("Better Auth + Convex Setup:")}\n${pc.cyan("•")} Set environment variables from ${pc.white("packages/backend")}:\n${pc.white("   cd packages/backend")}\n${pc.white(`   ${cmd} convex env set BETTER_AUTH_SECRET=$(openssl rand -base64 32)`)}\n` + (hasWeb ? `${pc.white(`   ${cmd} convex env set SITE_URL http://localhost:${webPort}`)}\n` : "");
+}
 function getPolarInstructions(backend) {
 	const envPath = backend === "self" ? "apps/web/.env" : "apps/server/.env";
 	return `${pc.bold("Polar Payments Setup:")}\n${pc.cyan("•")} Get access token & product ID from ${pc.underline("https://sandbox.polar.sh/")}\n${pc.cyan("•")} Set POLAR_ACCESS_TOKEN in ${envPath}`;
@@ -5280,7 +5682,7 @@ async function setPackageManagerVersion(projectDir, packageManager) {
 	if (!await fs.pathExists(pkgJsonPath)) return Result.ok(void 0);
 	const versionResult = await Result.tryPromise({
 		try: async () => {
-			const { stdout } = await $`${packageManager} -v`;
+			const { stdout } = await $({ cwd: os$1.tmpdir() })`${packageManager} -v`;
 			return stdout.trim();
 		},
 		catch: () => null
@@ -5560,121 +5962,8 @@ async function handleDirectoryConflictProgrammatically(currentPathInput, strateg
 	}
 }
 
-//#endregion
-//#region src/utils/open-url.ts
-async function openUrl(url) {
-	const platform = process.platform;
-	if ((await Result.tryPromise({
-		try: async () => {
-			if (platform === "darwin") await $({ stdio: "ignore" })`open ${url}`;
-			else if (platform === "win32") {
-				const escapedUrl = url.replace(/&/g, "^&");
-				await $({ stdio: "ignore" })`cmd /c start "" ${escapedUrl}`;
-			} else await $({ stdio: "ignore" })`xdg-open ${url}`;
-		},
-		catch: () => void 0
-	})).isErr()) log.message(`Please open ${url} in your browser.`);
-}
-
-//#endregion
-//#region src/utils/sponsors.ts
-const SPONSORS_JSON_URL = "https://sponsors.better-t-stack.dev/sponsors.json";
-async function fetchSponsors(url = SPONSORS_JSON_URL) {
-	const s = spinner();
-	s.start("Fetching sponsors…");
-	const response = await fetch(url);
-	if (!response.ok) {
-		s.stop(pc.red(`Failed to fetch sponsors: ${response.statusText}`));
-		throw new Error(`Failed to fetch sponsors: ${response.statusText}`);
-	}
-	const sponsors = await response.json();
-	s.stop("Sponsors fetched successfully!");
-	return sponsors;
-}
-function displaySponsors(sponsors) {
-	const { total_sponsors } = sponsors.summary;
-	if (total_sponsors === 0) {
-		log.info("No sponsors found. You can be the first one! ✨");
-		outro(pc.cyan("Visit https://github.com/sponsors/AmanVarshney01 to become a sponsor."));
-		return;
-	}
-	displaySponsorsBox(sponsors);
-	if (total_sponsors - sponsors.specialSponsors.length > 0) log.message(pc.blue(`+${total_sponsors - sponsors.specialSponsors.length} more amazing sponsors.\n`));
-	outro(pc.magenta("Visit https://github.com/sponsors/AmanVarshney01 to become a sponsor."));
-}
-function displaySponsorsBox(sponsors) {
-	if (sponsors.specialSponsors.length === 0) return;
-	let output = `${pc.bold(pc.cyan("-> Special Sponsors"))}\n\n`;
-	sponsors.specialSponsors.forEach((sponsor, idx) => {
-		const displayName = sponsor.name ?? sponsor.githubId;
-		const tier = sponsor.tierName ? ` ${pc.yellow(`(${sponsor.tierName})`)}` : "";
-		output += `${pc.green(`• ${displayName}`)}${tier}\n`;
-		output += `  ${pc.dim("GitHub:")} https://github.com/${sponsor.githubId}\n`;
-		const website = sponsor.websiteUrl ?? sponsor.githubUrl;
-		if (website) output += `  ${pc.dim("Website:")} ${website}\n`;
-		if (idx < sponsors.specialSponsors.length - 1) output += "\n";
-	});
-	consola$1.box(output);
-}
-
 //#endregion
 //#region src/index.ts
-function formatStackSummary(entry) {
-	const parts = [];
-	if (entry.stack.frontend.length > 0 && !entry.stack.frontend.includes("none")) parts.push(entry.stack.frontend.join(", "));
-	if (entry.stack.backend && entry.stack.backend !== "none") parts.push(entry.stack.backend);
-	if (entry.stack.database && entry.stack.database !== "none") parts.push(entry.stack.database);
-	if (entry.stack.orm && entry.stack.orm !== "none") parts.push(entry.stack.orm);
-	return parts.length > 0 ? parts.join(" + ") : "minimal";
-}
-function formatDate(isoString) {
-	return new Date(isoString).toLocaleDateString("en-US", {
-		year: "numeric",
-		month: "short",
-		day: "numeric",
-		hour: "2-digit",
-		minute: "2-digit"
-	});
-}
-async function historyHandler(input) {
-	if (input.clear) {
-		const clearResult = await clearHistory();
-		if (clearResult.isErr()) {
-			log.warn(pc.yellow(clearResult.error.message));
-			return;
-		}
-		log.success(pc.green("Project history cleared."));
-		return;
-	}
-	const historyResult = await getHistory(input.limit);
-	if (historyResult.isErr()) {
-		log.warn(pc.yellow(historyResult.error.message));
-		return;
-	}
-	const entries = historyResult.value;
-	if (entries.length === 0) {
-		log.info(pc.dim("No projects in history yet."));
-		log.info(pc.dim("Create a project with: create-better-t-stack my-app"));
-		return;
-	}
-	if (input.json) {
-		console.log(JSON.stringify(entries, null, 2));
-		return;
-	}
-	renderTitle();
-	intro(pc.magenta(`Project History (${entries.length} entries)`));
-	for (const [index, entry] of entries.entries()) {
-		const num = pc.dim(`${index + 1}.`);
-		const name = pc.cyan(pc.bold(entry.projectName));
-		const stack = pc.dim(formatStackSummary(entry));
-		log.message(`${num} ${name}`);
-		log.message(`   ${pc.dim("Created:")} ${formatDate(entry.createdAt)}`);
-		log.message(`   ${pc.dim("Path:")} ${entry.projectDir}`);
-		log.message(`   ${pc.dim("Stack:")} ${stack}`);
-		log.message(`   ${pc.dim("Command:")} ${pc.dim(entry.reproducibleCommand)}`);
-		log.message("");
-	}
-}
 const router = os.router({
 	create: os.meta({
 		description: "Create a new Better-T-Stack project",
@@ -5713,39 +6002,9 @@ const router = os.router({
 		});
 		if (options.verbose) return result;
 	}),
-	sponsors: os.meta({ description: "Show Better-T-Stack sponsors" }).handler(async () => {
-		const result = await Result.tryPromise({
-			try: async () => {
-				renderTitle();
-				intro(pc.magenta("Better-T-Stack Sponsors"));
-				displaySponsors(await fetchSponsors());
-			},
-			catch: (e) => new CLIError({
-				message: e instanceof Error ? e.message : "Failed to display sponsors",
-				cause: e
-			})
-		});
-		if (result.isErr()) {
-			displayError(result.error);
-			process.exit(1);
-		}
-	}),
-	docs: os.meta({ description: "Open Better-T-Stack documentation" }).handler(async () => {
-		const DOCS_URL = "https://better-t-stack.dev/docs";
-		if ((await Result.tryPromise({
-			try: () => openUrl(DOCS_URL),
-			catch: () => null
-		})).isOk()) log.success(pc.blue("Opened docs in your default browser."));
-		else log.message(`Please visit ${DOCS_URL}`);
-	}),
-	builder: os.meta({ description: "Open the web-based stack builder" }).handler(async () => {
-		const BUILDER_URL = "https://better-t-stack.dev/new";
-		if ((await Result.tryPromise({
-			try: () => openUrl(BUILDER_URL),
-			catch: () => null
-		})).isOk()) log.success(pc.blue("Opened builder in your default browser."));
-		else log.message(`Please visit ${BUILDER_URL}`);
-	}),
+	sponsors: os.meta({ description: "Show Better-T-Stack sponsors" }).handler(showSponsorsCommand),
+	docs: os.meta({ description: "Open Better-T-Stack documentation" }).handler(openDocsCommand),
+	builder: os.meta({ description: "Open the web-based stack builder" }).handler(openBuilderCommand),
 	add: os.meta({ description: "Add addons to an existing Better-T-Stack project" }).input(z.object({
 		addons: z.array(types_exports.AddonsSchema).optional().describe("Addons to add"),
 		install: z.boolean().optional().default(false).describe("Install dependencies after adding"),