mastra 0.10.12 → 0.10.13-alpha.1

package/dist/{chunk-SLWIYYJN.js → chunk-C56DSM55.js}

@@ -1,21 +1,213 @@
-import * as p from '@clack/prompts';
+import { getAnalytics } from './chunk-US7IPLZ2.js';
+import * as p2 from '@clack/prompts';
 import color2 from 'picocolors';
+import fs from 'fs/promises';
 import child_process from 'child_process';
 import util from 'util';
-import * as fs3 from 'fs';
-import fs3__default, { existsSync } from 'fs';
-import fs4 from 'fs/promises';
-import path2, { dirname } from 'path';
+import path3, { dirname } from 'path';
+import shellQuote from 'shell-quote';
+import yoctoSpinner from 'yocto-spinner';
+import { PinoLogger } from '@mastra/loggers';
+import * as fs4 from 'fs';
+import fs4__default, { existsSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { execa } from 'execa';
 import fsExtra3, { readJSON, ensureFile, writeJSON } from 'fs-extra/esm';
 import os from 'os';
 import prettier from 'prettier';
-import shellQuote from 'shell-quote';
-import yoctoSpinner from 'yocto-spinner';
-import { PinoLogger } from '@mastra/loggers';
 
-// src/commands/create/create.ts
+// src/commands/utils.ts
+function getPackageManager() {
+  const userAgent = process.env.npm_config_user_agent || "";
+  const execPath = process.env.npm_execpath || "";
+  if (userAgent.includes("yarn")) {
+    return "yarn";
+  }
+  if (userAgent.includes("pnpm")) {
+    return "pnpm";
+  }
+  if (userAgent.includes("npm")) {
+    return "npm";
+  }
+  if (execPath.includes("yarn")) {
+    return "yarn";
+  }
+  if (execPath.includes("pnpm")) {
+    return "pnpm";
+  }
+  if (execPath.includes("npm")) {
+    return "npm";
+  }
+  return "npm";
+}
+function getPackageManagerInstallCommand(pm) {
+  switch (pm) {
+    case "npm":
+      return "install";
+    case "yarn":
+      return "add";
+    case "pnpm":
+      return "add";
+    default:
+      return "install";
+  }
+}
+var logger = new PinoLogger({
+  name: "Mastra CLI",
+  level: "info"
+});
+
+// src/utils/clone-template.ts
+var exec = util.promisify(child_process.exec);
+async function cloneTemplate(options) {
+  const { template, projectName, targetDir } = options;
+  const projectPath = targetDir ? path3.resolve(targetDir, projectName) : path3.resolve(projectName);
+  const spinner4 = yoctoSpinner({ text: `Cloning template "${template.title}"...` }).start();
+  try {
+    if (await directoryExists(projectPath)) {
+      spinner4.error(`Directory ${projectName} already exists`);
+      throw new Error(`Directory ${projectName} already exists`);
+    }
+    await cloneRepositoryWithoutGit(template.githubUrl, projectPath);
+    await updatePackageJson(projectPath, projectName);
+    const envExamplePath = path3.join(projectPath, ".env.example");
+    if (await fileExists(envExamplePath)) {
+      await fs.copyFile(envExamplePath, path3.join(projectPath, ".env"));
+    }
+    spinner4.success(`Template "${template.title}" cloned successfully to ${projectName}`);
+    return projectPath;
+  } catch (error) {
+    spinner4.error(`Failed to clone template: ${error instanceof Error ? error.message : "Unknown error"}`);
+    throw error;
+  }
+}
+async function directoryExists(dirPath) {
+  try {
+    const stat = await fs.stat(dirPath);
+    return stat.isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function fileExists(filePath) {
+  try {
+    const stat = await fs.stat(filePath);
+    return stat.isFile();
+  } catch {
+    return false;
+  }
+}
+async function cloneRepositoryWithoutGit(repoUrl, targetPath) {
+  await fs.mkdir(targetPath, { recursive: true });
+  try {
+    const degitRepo = repoUrl.replace("https://github.com/", "");
+    const degitCommand = shellQuote.quote(["npx", "degit", degitRepo, targetPath]);
+    await exec(degitCommand, {
+      cwd: process.cwd()
+    });
+  } catch {
+    try {
+      const gitCommand = shellQuote.quote(["git", "clone", repoUrl, targetPath]);
+      await exec(gitCommand, {
+        cwd: process.cwd()
+      });
+      const gitDir = path3.join(targetPath, ".git");
+      if (await directoryExists(gitDir)) {
+        await fs.rm(gitDir, { recursive: true, force: true });
+      }
+    } catch (gitError) {
+      throw new Error(`Failed to clone repository: ${gitError instanceof Error ? gitError.message : "Unknown error"}`);
+    }
+  }
+}
+async function updatePackageJson(projectPath, projectName) {
+  const packageJsonPath = path3.join(projectPath, "package.json");
+  try {
+    const packageJsonContent = await fs.readFile(packageJsonPath, "utf-8");
+    const packageJson = JSON.parse(packageJsonContent);
+    packageJson.name = projectName;
+    await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2), "utf-8");
+  } catch (error) {
+    logger.warn(`Could not update package.json: ${error instanceof Error ? error.message : "Unknown error"}`);
+  }
+}
+async function installDependencies(projectPath, packageManager) {
+  const spinner4 = yoctoSpinner({ text: "Installing dependencies..." }).start();
+  try {
+    const pm = packageManager || getPackageManager();
+    const installCommand = shellQuote.quote([pm, "install"]);
+    await exec(installCommand, {
+      cwd: projectPath
+    });
+    spinner4.success("Dependencies installed successfully");
+  } catch (error) {
+    spinner4.error(`Failed to install dependencies: ${error instanceof Error ? error.message : "Unknown error"}`);
+    throw error;
+  }
+}
+var TEMPLATES_API_URL = process.env.MASTRA_TEMPLATES_API_URL || "https://mastra.ai/api/templates.json";
+async function loadTemplates() {
+  try {
+    const response = await fetch(TEMPLATES_API_URL);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch templates: ${response.statusText}`);
+    }
+    const templates = await response.json();
+    return templates;
+  } catch (error) {
+    console.error("Error loading templates:", error);
+    throw new Error("Failed to load templates. Please check your internet connection and try again.");
+  }
+}
+function pluralize(count, singular, plural) {
+  return count === 1 ? singular : plural || `${singular}s`;
+}
+async function selectTemplate(templates) {
+  const choices = templates.map((template) => {
+    const parts = [];
+    if (template.agents?.length) {
+      parts.push(`${template.agents.length} ${pluralize(template.agents.length, "agent")}`);
+    }
+    if (template.tools?.length) {
+      parts.push(`${template.tools.length} ${pluralize(template.tools.length, "tool")}`);
+    }
+    if (template.workflows?.length) {
+      parts.push(`${template.workflows.length} ${pluralize(template.workflows.length, "workflow")}`);
+    }
+    if (template.mcp?.length) {
+      parts.push(`${template.mcp.length} ${pluralize(template.mcp.length, "MCP server")}`);
+    }
+    if (template.networks?.length) {
+      parts.push(`${template.networks.length} ${pluralize(template.networks.length, "agent network")}`);
+    }
+    return {
+      value: template,
+      label: template.title,
+      hint: parts.join(", ") || "Template components"
+    };
+  });
+  const selected = await p2.select({
+    message: "Select a template:",
+    options: choices
+  });
+  if (p2.isCancel(selected)) {
+    return null;
+  }
+  return selected;
+}
+function findTemplateByName(templates, templateName) {
+  let template = templates.find((t) => t.slug === templateName);
+  if (template) return template;
+  const slugWithPrefix = `template-${templateName}`;
+  template = templates.find((t) => t.slug === slugWithPrefix);
+  if (template) return template;
+  template = templates.find((t) => t.title.toLowerCase() === templateName.toLowerCase());
+  if (template) return template;
+  return null;
+}
+function getDefaultProjectName(template) {
+  return template.slug.replace(/^template-/, "");
+}
 var DepsService = class {
   packageManager;
   constructor() {
@@ -24,11 +216,11 @@ var DepsService = class {
   findLockFile(dir) {
     const lockFiles = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock", "bun.lock"];
     for (const file of lockFiles) {
-      if (fs3__default.existsSync(path2.join(dir, file))) {
+      if (fs4__default.existsSync(path3.join(dir, file))) {
         return file;
       }
     }
-    const parentDir = path2.resolve(dir, "..");
+    const parentDir = path3.resolve(dir, "..");
     if (parentDir !== dir) {
       return this.findLockFile(parentDir);
     }
@@ -65,13 +257,13 @@ var DepsService = class {
   }
   async checkDependencies(dependencies) {
     try {
-      const packageJsonPath = path2.join(process.cwd(), "package.json");
+      const packageJsonPath = path3.join(process.cwd(), "package.json");
       try {
-        await fs4.access(packageJsonPath);
+        await fs.access(packageJsonPath);
       } catch {
         return "No package.json file found in the current directory";
       }
-      const packageJson = JSON.parse(await fs4.readFile(packageJsonPath, "utf-8"));
+      const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf-8"));
       for (const dependency of dependencies) {
         if (!packageJson.dependencies || !packageJson.dependencies[dependency]) {
           return `Please install ${dependency} before running this command (${this.packageManager} install ${dependency})`;
@@ -85,8 +277,8 @@ var DepsService = class {
   }
   async getProjectName() {
     try {
-      const packageJsonPath = path2.join(process.cwd(), "package.json");
-      const packageJson = await fs4.readFile(packageJsonPath, "utf-8");
+      const packageJsonPath = path3.join(process.cwd(), "package.json");
+      const packageJson = await fs.readFile(packageJsonPath, "utf-8");
       const pkg = JSON.parse(packageJson);
       return pkg.name;
     } catch (err) {
@@ -96,56 +288,19 @@ var DepsService = class {
   async getPackageVersion() {
     const __filename = fileURLToPath(import.meta.url);
     const __dirname = dirname(__filename);
-    const pkgJsonPath = path2.join(__dirname, "..", "package.json");
+    const pkgJsonPath = path3.join(__dirname, "..", "package.json");
     const content = await fsExtra3.readJSON(pkgJsonPath);
     return content.version;
   }
   async addScriptsToPackageJson(scripts) {
-    const packageJson = JSON.parse(await fs4.readFile("package.json", "utf-8"));
+    const packageJson = JSON.parse(await fs.readFile("package.json", "utf-8"));
     packageJson.scripts = {
       ...packageJson.scripts,
       ...scripts
     };
-    await fs4.writeFile("package.json", JSON.stringify(packageJson, null, 2));
+    await fs.writeFile("package.json", JSON.stringify(packageJson, null, 2));
   }
 };
-
-// src/commands/utils.ts
-function getPackageManager() {
-  const userAgent = process.env.npm_config_user_agent || "";
-  const execPath = process.env.npm_execpath || "";
-  if (userAgent.includes("yarn")) {
-    return "yarn";
-  }
-  if (userAgent.includes("pnpm")) {
-    return "pnpm";
-  }
-  if (userAgent.includes("npm")) {
-    return "npm";
-  }
-  if (execPath.includes("yarn")) {
-    return "yarn";
-  }
-  if (execPath.includes("pnpm")) {
-    return "pnpm";
-  }
-  if (execPath.includes("npm")) {
-    return "npm";
-  }
-  return "npm";
-}
-function getPackageManagerInstallCommand(pm) {
-  switch (pm) {
-    case "npm":
-      return "install";
-    case "yarn":
-      return "add";
-    case "pnpm":
-      return "add";
-    default:
-      return "install";
-  }
-}
 var args = ["-y", "@mastra/mcp-docs-server"];
 var createMcpConfig = (editor) => {
   if (editor === "vscode") {
@@ -198,19 +353,19 @@ async function writeMergedConfig(configPath, editor) {
     spaces: 2
   });
 }
-var windsurfGlobalMCPConfigPath = path2.join(os.homedir(), ".codeium", "windsurf", "mcp_config.json");
-var cursorGlobalMCPConfigPath = path2.join(os.homedir(), ".cursor", "mcp.json");
-path2.join(process.cwd(), ".vscode", "mcp.json");
-var vscodeGlobalMCPConfigPath = path2.join(
+var windsurfGlobalMCPConfigPath = path3.join(os.homedir(), ".codeium", "windsurf", "mcp_config.json");
+var cursorGlobalMCPConfigPath = path3.join(os.homedir(), ".cursor", "mcp.json");
+path3.join(process.cwd(), ".vscode", "mcp.json");
+var vscodeGlobalMCPConfigPath = path3.join(
   os.homedir(),
-  process.platform === "win32" ? path2.join("AppData", "Roaming", "Code", "User", "settings.json") : process.platform === "darwin" ? path2.join("Library", "Application Support", "Code", "User", "settings.json") : path2.join(".config", "Code", "User", "settings.json")
+  process.platform === "win32" ? path3.join("AppData", "Roaming", "Code", "User", "settings.json") : process.platform === "darwin" ? path3.join("Library", "Application Support", "Code", "User", "settings.json") : path3.join(".config", "Code", "User", "settings.json")
 );
 async function installMastraDocsMCPServer({ editor, directory }) {
   if (editor === `cursor`) {
-    await writeMergedConfig(path2.join(directory, ".cursor", "mcp.json"), "cursor");
+    await writeMergedConfig(path3.join(directory, ".cursor", "mcp.json"), "cursor");
   }
   if (editor === `vscode`) {
-    await writeMergedConfig(path2.join(directory, ".vscode", "mcp.json"), "vscode");
+    await writeMergedConfig(path3.join(directory, ".vscode", "mcp.json"), "vscode");
   }
   if (editor === `cursor-global`) {
     const alreadyInstalled = await globalMCPIsAlreadyInstalled(editor);
@@ -272,7 +427,7 @@ var FileEnvService = class extends EnvService {
   }
   readFile(filePath) {
     return new Promise((resolve, reject) => {
-      fs3.readFile(filePath, "utf8", (err, data) => {
+      fs4.readFile(filePath, "utf8", (err, data) => {
         if (err) reject(err);
         else resolve(data);
       });
@@ -280,7 +435,7 @@ var FileEnvService = class extends EnvService {
   }
   writeFile({ filePath, data }) {
     return new Promise((resolve, reject) => {
-      fs3.writeFile(filePath, data, "utf8", (err) => {
+      fs4.writeFile(filePath, data, "utf8", (err) => {
         if (err) reject(err);
         else resolve();
       });
@@ -335,10 +490,10 @@ var FileService = class {
    */
   async copyStarterFile(inputFile, outputFilePath, replaceIfExists) {
     const __filename = fileURLToPath(import.meta.url);
-    const __dirname = path2.dirname(__filename);
-    const filePath = path2.resolve(__dirname, "starter-files", inputFile);
-    const fileString = fs3__default.readFileSync(filePath, "utf8");
-    if (fs3__default.existsSync(outputFilePath) && !replaceIfExists) {
+    const __dirname = path3.dirname(__filename);
+    const filePath = path3.resolve(__dirname, "starter-files", inputFile);
+    const fileString = fs4__default.readFileSync(filePath, "utf8");
+    if (fs4__default.existsSync(outputFilePath) && !replaceIfExists) {
       console.log(`${outputFilePath} already exists`);
       return false;
     }
@@ -346,14 +501,14 @@ var FileService = class {
     return true;
   }
   async setupEnvFile({ dbUrl }) {
-    const envPath = path2.join(process.cwd(), ".env.development");
+    const envPath = path3.join(process.cwd(), ".env.development");
     await fsExtra3.ensureFile(envPath);
     const fileEnvService = new FileEnvService(envPath);
     await fileEnvService.setEnvValue("DB_URL", dbUrl);
   }
   getFirstExistingFile(files) {
     for (const f of files) {
-      if (fs3__default.existsSync(f)) {
+      if (fs4__default.existsSync(f)) {
         return f;
       }
     }
@@ -363,20 +518,16 @@ var FileService = class {
     filePath,
     replacements
   }) {
-    let fileContent = fs3__default.readFileSync(filePath, "utf8");
+    let fileContent = fs4__default.readFileSync(filePath, "utf8");
     replacements.forEach(({ search, replace }) => {
       fileContent = fileContent.replaceAll(search, replace);
     });
-    fs3__default.writeFileSync(filePath, fileContent);
+    fs4__default.writeFileSync(filePath, fileContent);
   }
 };
-var logger = new PinoLogger({
-  name: "Mastra CLI",
-  level: "info"
-});
 
 // src/commands/init/utils.ts
-var exec = util.promisify(child_process.exec);
+var exec2 = util.promisify(child_process.exec);
 var getAISDKPackage = (llmProvider) => {
   switch (llmProvider) {
     case "openai":
@@ -453,8 +604,8 @@ export const weatherAgent = new Agent({
     parser: "typescript",
     singleQuote: true
   });
-  await fs4.writeFile(destPath, "");
-  await fs4.writeFile(destPath, formattedContent);
+  await fs.writeFile(destPath, "");
+  await fs.writeFile(destPath, formattedContent);
 }
 async function writeWorkflowSample(destPath) {
   const content = `import { createStep, createWorkflow } from '@mastra/core/workflows';
@@ -647,7 +798,7 @@ export { weatherWorkflow };`;
     semi: true,
     singleQuote: true
   });
-  await fs4.writeFile(destPath, formattedContent);
+  await fs.writeFile(destPath, formattedContent);
 }
 async function writeToolSample(destPath) {
   const fileService = new FileService();
@@ -676,15 +827,15 @@ var writeIndexFile = async ({
   addWorkflow
 }) => {
   const indexPath = dirPath + "/index.ts";
-  const destPath = path2.join(indexPath);
+  const destPath = path3.join(indexPath);
   try {
-    await fs4.writeFile(destPath, "");
+    await fs.writeFile(destPath, "");
     const filteredExports = [
       addWorkflow ? `workflows: { weatherWorkflow },` : "",
       addAgent ? `agents: { weatherAgent },` : ""
     ].filter(Boolean);
     if (!addExample) {
-      await fs4.writeFile(
+      await fs.writeFile(
         destPath,
         `
 import { Mastra } from '@mastra/core';
@@ -694,7 +845,7 @@ export const mastra = new Mastra()
       );
       return;
     }
-    await fs4.writeFile(
+    await fs.writeFile(
       destPath,
       `
 import { Mastra } from '@mastra/core/mastra';
@@ -736,16 +887,16 @@ var checkAndInstallCoreDeps = async (addExample) => {
 var spinner = yoctoSpinner({ text: "Installing Mastra core dependencies\n" });
 async function installCoreDeps(pkg) {
   try {
-    const confirm2 = await p.confirm({
+    const confirm2 = await p2.confirm({
       message: `You do not have the ${pkg} package installed. Would you like to install it?`,
       initialValue: false
     });
-    if (p.isCancel(confirm2)) {
-      p.cancel("Installation Cancelled");
+    if (p2.isCancel(confirm2)) {
+      p2.cancel("Installation Cancelled");
       process.exit(0);
     }
     if (!confirm2) {
-      p.cancel("Installation Cancelled");
+      p2.cancel("Installation Cancelled");
       process.exit(0);
     }
     spinner.start();
@@ -782,13 +933,13 @@ var writeAPIKey = async ({
   const key = await getAPIKey(provider);
   const escapedKey = shellQuote.quote([key]);
   const escapedApiKey = shellQuote.quote([apiKey]);
-  await exec(`echo ${escapedKey}=${escapedApiKey} >> .env`);
+  await exec2(`echo ${escapedKey}=${escapedApiKey} >> .env`);
 };
 var createMastraDir = async (directory) => {
   let dir = directory.trim().split("/").filter((item) => item !== "");
-  const dirPath = path2.join(process.cwd(), ...dir, "mastra");
+  const dirPath = path3.join(process.cwd(), ...dir, "mastra");
   try {
-    await fs4.access(dirPath);
+    await fs.access(dirPath);
     return { ok: false };
   } catch {
     await fsExtra3.ensureDir(dirPath);
@@ -804,15 +955,15 @@ var writeCodeSample = async (dirPath, component, llmProvider, importComponents)
   }
 };
 var interactivePrompt = async () => {
-  p.intro(color2.inverse(" Mastra Init "));
-  const mastraProject = await p.group(
+  p2.intro(color2.inverse(" Mastra Init "));
+  const mastraProject = await p2.group(
     {
-      directory: () => p.text({
+      directory: () => p2.text({
         message: "Where should we create the Mastra files? (default: src/)",
         placeholder: "src/",
         defaultValue: "src/"
       }),
-      llmProvider: () => p.select({
+      llmProvider: () => p2.select({
         message: "Select default provider:",
         options: [
           { value: "openai", label: "OpenAI", hint: "recommended" },
@@ -823,7 +974,7 @@ var interactivePrompt = async () => {
         ]
       }),
       llmApiKey: async ({ results: { llmProvider } }) => {
-        const keyChoice = await p.select({
+        const keyChoice = await p2.select({
           message: `Enter your ${llmProvider} API key?`,
           options: [
             { value: "skip", label: "Skip for now", hint: "default" },
@@ -832,7 +983,7 @@ var interactivePrompt = async () => {
           initialValue: "skip"
         });
         if (keyChoice === "enter") {
-          return p.text({
+          return p2.text({
             message: "Enter your API key:",
             placeholder: "sk-..."
           });
@@ -843,7 +994,7 @@ var interactivePrompt = async () => {
         const windsurfIsAlreadyInstalled = await globalMCPIsAlreadyInstalled(`windsurf`);
         const cursorIsAlreadyInstalled = await globalMCPIsAlreadyInstalled(`cursor`);
         const vscodeIsAlreadyInstalled = await globalMCPIsAlreadyInstalled(`vscode`);
-        const editor = await p.select({
+        const editor = await p2.select({
           message: `Make your AI IDE into a Mastra expert? (installs Mastra docs MCP server)`,
           options: [
             { value: "skip", label: "Skip for now", hint: "default" },
@@ -871,24 +1022,24 @@ var interactivePrompt = async () => {
         });
         if (editor === `skip`) return void 0;
         if (editor === `windsurf` && windsurfIsAlreadyInstalled) {
-          p.log.message(`
+          p2.log.message(`
 Windsurf is already installed, skipping.`);
           return void 0;
         }
         if (editor === `vscode` && vscodeIsAlreadyInstalled) {
-          p.log.message(`
+          p2.log.message(`
 VSCode is already installed, skipping.`);
           return void 0;
         }
         if (editor === `cursor`) {
-          p.log.message(
+          p2.log.message(
             `
 Note: you will need to go into Cursor Settings -> MCP Settings and manually enable the installed Mastra MCP server.
 `
           );
         }
         if (editor === `cursor-global`) {
-          const confirm2 = await p.select({
+          const confirm2 = await p2.select({
             message: `Global install will add/update ${cursorGlobalMCPConfigPath} and make the Mastra docs MCP server available in all your Cursor projects. Continue?`,
             options: [
               { value: "yes", label: "Yes, I understand" },
@@ -900,7 +1051,7 @@ Note: you will need to go into Cursor Settings -> MCP Settings and manually enab
           }
         }
         if (editor === `windsurf`) {
-          const confirm2 = await p.select({
+          const confirm2 = await p2.select({
             message: `Windsurf only supports a global MCP config (at ${windsurfGlobalMCPConfigPath}) is it ok to add/update that global config?
 This means the Mastra docs MCP server will be available in all your Windsurf projects.`,
             options: [
@@ -917,7 +1068,7 @@ This means the Mastra docs MCP server will be available in all your Windsurf pro
     },
     {
       onCancel: () => {
-        p.cancel("Operation cancelled.");
+        p2.cancel("Operation cancelled.");
         process.exit(0);
       }
     }
@@ -926,7 +1077,7 @@ This means the Mastra docs MCP server will be available in all your Windsurf pro
 };
 var checkPkgJson = async () => {
   const cwd = process.cwd();
-  const pkgJsonPath = path2.join(cwd, "package.json");
+  const pkgJsonPath = path3.join(cwd, "package.json");
   let isPkgJsonPresent = false;
   try {
     await fsExtra3.readJSON(pkgJsonPath);
@@ -942,8 +1093,8 @@ var checkPkgJson = async () => {
 };
 
 // src/commands/init/init.ts
-var s = p.spinner();
-var exec2 = util.promisify(child_process.exec);
+var s = p2.spinner();
+var exec3 = util.promisify(child_process.exec);
 var init = async ({
   directory,
   addExample = false,
@@ -995,7 +1146,7 @@ var init = async ({
     const depsService = new DepsService();
     const pm = depsService.packageManager;
     const installCommand = getPackageManagerInstallCommand(pm);
-    await exec2(`${pm} ${installCommand} ${aiSdkPackage}`);
+    await exec3(`${pm} ${installCommand} ${aiSdkPackage}`);
     if (configureEditorWithDocsMCP) {
       await installMastraDocsMCPServer({
         editor: configureEditorWithDocsMCP,
@@ -1004,14 +1155,14 @@ var init = async ({
     }
     s.stop();
     if (!llmApiKey) {
-      p.note(`
+      p2.note(`
       ${color2.green("Mastra initialized successfully!")}
 
       Add your ${color2.cyan(key)} as an environment variable
       in your ${color2.cyan(".env")} file
       `);
     } else {
-      p.note(`
+      p2.note(`
       ${color2.green("Mastra initialized successfully!")}
       `);
     }
@@ -1022,10 +1173,10 @@ var init = async ({
     return { success: false };
   }
 };
-var exec3 = util.promisify(child_process.exec);
+var exec4 = util.promisify(child_process.exec);
 var execWithTimeout = async (command, timeoutMs) => {
   try {
-    const promise = exec3(command, { killSignal: "SIGTERM" });
+    const promise = exec4(command, { killSignal: "SIGTERM" });
     if (!timeoutMs) {
       return await promise;
     }
@@ -1075,21 +1226,21 @@ var createMastraProject = async ({
   createVersionTag,
   timeout
 }) => {
-  p.intro(color2.inverse(" Mastra Create "));
-  const projectName = name ?? await p.text({
+  p2.intro(color2.inverse(" Mastra Create "));
+  const projectName = name ?? await p2.text({
     message: "What do you want to name your project?",
     placeholder: "my-mastra-app",
     defaultValue: "my-mastra-app"
   });
-  if (p.isCancel(projectName)) {
-    p.cancel("Operation cancelled");
+  if (p2.isCancel(projectName)) {
+    p2.cancel("Operation cancelled");
     process.exit(0);
   }
-  const s2 = p.spinner();
+  const s2 = p2.spinner();
   try {
     s2.start("Creating project");
     try {
-      await fs4.mkdir(projectName);
+      await fs.mkdir(projectName);
     } catch (error) {
       if (error instanceof Error && "code" in error && error.code === "EEXIST") {
         s2.stop(`A directory named "${projectName}" already exists. Please choose a different name.`);
@@ -1104,9 +1255,9 @@ var createMastraProject = async ({
     const installCommand = getPackageManagerInstallCommand(pm);
     s2.message("Initializing project structure");
     try {
-      await exec3(`npm init -y`);
-      await exec3(`npm pkg set type="module"`);
-      await exec3(`npm pkg set engines.node=">=20.9.0"`);
+      await exec4(`npm init -y`);
+      await exec4(`npm pkg set type="module"`);
+      await exec4(`npm pkg set engines.node=">=20.9.0"`);
       const depsService = new DepsService();
       await depsService.addScriptsToPackageJson({
         dev: "mastra dev",
@@ -1121,9 +1272,9 @@ var createMastraProject = async ({
     s2.stop("Project structure created");
     s2.start(`Installing ${pm} dependencies`);
     try {
-      await exec3(`${pm} ${installCommand} zod@^3`);
-      await exec3(`${pm} ${installCommand} typescript @types/node --save-dev`);
-      await exec3(`echo '{
+      await exec4(`${pm} ${installCommand} zod@^3`);
+      await exec4(`${pm} ${installCommand} typescript @types/node --save-dev`);
+      await exec4(`echo '{
   "compilerOptions": {
     "target": "ES2022",
     "module": "ES2022",
@@ -1166,31 +1317,35 @@ var createMastraProject = async ({
     s2.stop("Mastra dependencies installed");
     s2.start("Adding .gitignore");
     try {
-      await exec3(`echo output.txt >> .gitignore`);
-      await exec3(`echo node_modules >> .gitignore`);
-      await exec3(`echo dist >> .gitignore`);
-      await exec3(`echo .mastra >> .gitignore`);
-      await exec3(`echo .env.development >> .gitignore`);
-      await exec3(`echo .env >> .gitignore`);
-      await exec3(`echo *.db >> .gitignore`);
-      await exec3(`echo *.db-* >> .gitignore`);
+      await exec4(`echo output.txt >> .gitignore`);
+      await exec4(`echo node_modules >> .gitignore`);
+      await exec4(`echo dist >> .gitignore`);
+      await exec4(`echo .mastra >> .gitignore`);
+      await exec4(`echo .env.development >> .gitignore`);
+      await exec4(`echo .env >> .gitignore`);
+      await exec4(`echo *.db >> .gitignore`);
+      await exec4(`echo *.db-* >> .gitignore`);
     } catch (error) {
       throw new Error(`Failed to create .gitignore: ${error instanceof Error ? error.message : "Unknown error"}`);
     }
     s2.stop(".gitignore added");
-    p.outro("Project created successfully");
+    p2.outro("Project created successfully");
     console.log("");
     return { projectName };
   } catch (error) {
     s2.stop();
     const errorMessage = error instanceof Error ? error.message : "An unexpected error occurred";
-    p.cancel(`Project creation failed: ${errorMessage}`);
+    p2.cancel(`Project creation failed: ${errorMessage}`);
     process.exit(1);
   }
 };
 
 // src/commands/create/create.ts
 var create = async (args2) => {
+  if (args2.template !== void 0) {
+    await createFromTemplate(args2);
+    return;
+  }
   const { projectName } = await createMastraProject({
     projectName: args2?.projectName,
     createVersionTag: args2?.createVersionTag,
@@ -1199,6 +1354,13 @@ var create = async (args2) => {
   const directory = args2.directory || "src/";
   if (args2.components === void 0 || args2.llmProvider === void 0 || args2.addExample === void 0) {
     const result = await interactivePrompt();
+    const analytics2 = getAnalytics();
+    if (analytics2 && result?.llmProvider) {
+      analytics2.trackEvent("cli_model_provider_selected", {
+        provider: result.llmProvider,
+        selection_method: "interactive"
+      });
+    }
     await init({
       ...result,
       llmApiKey: result?.llmApiKey,
@@ -1209,6 +1371,13 @@ var create = async (args2) => {
     return;
   }
   const { components = [], llmProvider = "openai", addExample = false, llmApiKey } = args2;
+  const analytics = getAnalytics();
+  if (analytics) {
+    analytics.trackEvent("cli_model_provider_selected", {
+      provider: llmProvider,
+      selection_method: "cli_args"
+    });
+  }
   await init({
     directory,
     components,
@@ -1221,12 +1390,71 @@ var create = async (args2) => {
 };
 var postCreate = ({ projectName }) => {
   const packageManager = getPackageManager();
-  p.outro(`
+  p2.outro(`
    ${color2.green("To start your project:")}
 
     ${color2.cyan("cd")} ${projectName}
     ${color2.cyan(`${packageManager} run dev`)}
   `);
 };
+async function createFromTemplate(args2) {
+  const templates = await loadTemplates();
+  let selectedTemplate;
+  if (args2.template === true) {
+    selectedTemplate = await selectTemplate(templates);
+    if (!selectedTemplate) {
+      p2.log.info("No template selected. Exiting.");
+      return;
+    }
+  } else if (args2.template) {
+    selectedTemplate = findTemplateByName(templates, args2.template);
+    if (!selectedTemplate) {
+      p2.log.error(`Template "${args2.template}" not found. Available templates:`);
+      templates.forEach((t) => p2.log.info(`  - ${t.title} (use: ${t.slug.replace("template-", "")})`));
+      throw new Error(`Template "${args2.template}" not found`);
+    }
+  }
+  if (!selectedTemplate) {
+    throw new Error("No template selected");
+  }
+  let projectName = args2.projectName;
+  if (!projectName) {
+    const defaultName = getDefaultProjectName(selectedTemplate);
+    const response = await p2.text({
+      message: "What is your project name?",
+      defaultValue: defaultName,
+      placeholder: defaultName
+    });
+    if (p2.isCancel(response)) {
+      p2.log.info("Project creation cancelled.");
+      return;
+    }
+    projectName = response;
+  }
+  try {
+    const analytics = getAnalytics();
+    if (analytics) {
+      analytics.trackEvent("cli_template_used", {
+        template_slug: selectedTemplate.slug,
+        template_title: selectedTemplate.title
+      });
+    }
+    const projectPath = await cloneTemplate({
+      template: selectedTemplate,
+      projectName
+    });
+    await installDependencies(projectPath);
+    p2.note(`
+      ${color2.green("Mastra template installed!")}
+
+      Add the necessary environment 
+      variables in your ${color2.cyan(".env")} file
+      `);
+    postCreate({ projectName });
+  } catch (error) {
+    p2.log.error(`Failed to create project from template: ${error instanceof Error ? error.message : "Unknown error"}`);
+    throw error;
+  }
+}
 
 export { DepsService, FileService, checkAndInstallCoreDeps, checkPkgJson, create, init, interactivePrompt, logger };