create-mastra 0.10.11 → 0.10.12-alpha.1

package/dist/index.js

@@ -1,10 +1,10 @@
 #! /usr/bin/env node
 import { Command } from 'commander';
 import { randomUUID } from 'node:crypto';
-import * as fs3__default from 'node:fs';
-import fs3__default__default, { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import * as fs4__default from 'node:fs';
+import fs4__default__default, { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import os from 'node:os';
-import path2, { dirname } from 'node:path';
+import path3, { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { PostHog } from 'posthog-node';
 import util, { stripVTControlCharacters } from 'node:util';
@@ -12,18 +12,22 @@ import y$1, { stdout, stdin } from 'node:process';
 import * as g from 'node:readline';
 import g__default from 'node:readline';
 import { Writable } from 'node:stream';
+import fs from 'node:fs/promises';
 import child_process from 'node:child_process';
-import fs4 from 'node:fs/promises';
-import { execa } from 'execa';
-import fsExtra3, { readJSON, ensureFile, writeJSON } from 'fs-extra/esm';
-import prettier from 'prettier';
 import tty from 'node:tty';
 import pino from 'pino';
 import pretty from 'pino-pretty';
+import { execa } from 'execa';
+import fsExtra3, { readJSON, ensureFile, writeJSON } from 'fs-extra/esm';
+import prettier from 'prettier';
 import fsExtra from 'fs-extra';
 
 var __filename = fileURLToPath(import.meta.url);
-var __dirname = path2.dirname(__filename);
+var __dirname = path3.dirname(__filename);
+var analyticsInstance = null;
+function getAnalytics() {
+  return analyticsInstance;
+}
 var PosthogAnalytics = class {
   sessionId;
   client;
@@ -35,7 +39,7 @@ var PosthogAnalytics = class {
     host = "https://app.posthog.com"
   }) {
     this.version = version;
-    const cliConfigPath = path2.join(__dirname, "mastra-cli.json");
+    const cliConfigPath = path3.join(__dirname, "mastra-cli.json");
     if (existsSync(cliConfigPath)) {
       try {
         const { distinctId, sessionId } = JSON.parse(readFileSync(cliConfigPath, "utf-8"));
@@ -63,7 +67,7 @@ var PosthogAnalytics = class {
   }
   writeCliConfig({ distinctId, sessionId }) {
     try {
-      writeFileSync(path2.join(__dirname, "mastra-cli.json"), JSON.stringify({ distinctId, sessionId }));
+      writeFileSync(path3.join(__dirname, "mastra-cli.json"), JSON.stringify({ distinctId, sessionId }));
     } catch {
     }
   }
@@ -113,6 +117,22 @@ var PosthogAnalytics = class {
       }
     });
   }
+  trackEvent(eventName, properties) {
+    try {
+      if (!this.client) {
+        return;
+      }
+      this.client.capture({
+        distinctId: this.distinctId,
+        event: eventName,
+        properties: {
+          ...this.getSystemProperties(),
+          ...properties
+        }
+      });
+    } catch {
+    }
+  }
   trackCommand(options) {
     try {
       if (!this.client) {
@@ -1153,6 +1173,195 @@ var PinoLogger = class extends MastraLogger {
   }
 };
 
+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"
+});
+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 ve({
+    message: "Select a template:",
+    options: choices
+  });
+  if (pD(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() {
@@ -1161,11 +1370,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__default.existsSync(path2.join(dir, file))) {
+      if (fs4__default__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);
     }
@@ -1202,13 +1411,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})`;
@@ -1222,8 +1431,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) {
@@ -1233,54 +1442,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));
   }
 };
-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") {
@@ -1333,19 +1507,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);
@@ -1403,7 +1577,7 @@ var FileEnvService = class extends EnvService {
   }
   readFile(filePath) {
     return new Promise((resolve, reject) => {
-      fs3__default.readFile(filePath, "utf8", (err, data) => {
+      fs4__default.readFile(filePath, "utf8", (err, data) => {
         if (err) reject(err);
         else resolve(data);
       });
@@ -1411,7 +1585,7 @@ var FileEnvService = class extends EnvService {
   }
   writeFile({ filePath, data }) {
     return new Promise((resolve, reject) => {
-      fs3__default.writeFile(filePath, data, "utf8", (err) => {
+      fs4__default.writeFile(filePath, data, "utf8", (err) => {
         if (err) reject(err);
         else resolve();
       });
@@ -1464,10 +1638,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__default.readFileSync(filePath, "utf8");
-    if (fs3__default__default.existsSync(outputFilePath) && !replaceIfExists) {
+    const __dirname = path3.dirname(__filename);
+    const filePath = path3.resolve(__dirname, "starter-files", inputFile);
+    const fileString = fs4__default__default.readFileSync(filePath, "utf8");
+    if (fs4__default__default.existsSync(outputFilePath) && !replaceIfExists) {
       console.log(`${outputFilePath} already exists`);
       return false;
     }
@@ -1475,14 +1649,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__default.existsSync(f)) {
+      if (fs4__default__default.existsSync(f)) {
         return f;
       }
     }
@@ -1492,18 +1666,14 @@ var FileService = class {
     filePath,
     replacements
   }) {
-    let fileContent = fs3__default__default.readFileSync(filePath, "utf8");
+    let fileContent = fs4__default__default.readFileSync(filePath, "utf8");
     replacements.forEach(({ search, replace }) => {
       fileContent = fileContent.replaceAll(search, replace);
     });
-    fs3__default__default.writeFileSync(filePath, fileContent);
+    fs4__default__default.writeFileSync(filePath, fileContent);
   }
 };
-new PinoLogger({
-  name: "Mastra CLI",
-  level: "info"
-});
-var exec = util.promisify(child_process.exec);
+var exec2 = util.promisify(child_process.exec);
 var getAISDKPackage = (llmProvider) => {
   switch (llmProvider) {
     case "openai":
@@ -1580,8 +1750,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';
@@ -1774,7 +1944,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();
@@ -1803,15 +1973,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';
@@ -1821,7 +1991,7 @@ export const mastra = new Mastra()
       );
       return;
     }
-    await fs4.writeFile(
+    await fs.writeFile(
       destPath,
       `
 import { Mastra } from '@mastra/core/mastra';
@@ -1874,13 +2044,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);
@@ -2017,7 +2187,7 @@ This means the Mastra docs MCP server will be available in all your Windsurf pro
   return mastraProject;
 };
 var s = Y();
-var exec2 = util.promisify(child_process.exec);
+var exec3 = util.promisify(child_process.exec);
 var init = async ({
   directory,
   addExample = false,
@@ -2069,7 +2239,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,
@@ -2096,10 +2266,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;
     }
@@ -2163,7 +2333,7 @@ var createMastraProject = async ({
   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.`);
@@ -2178,9 +2348,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",
@@ -2195,9 +2365,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",
@@ -2240,14 +2410,14 @@ 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"}`);
     }
@@ -2263,6 +2433,10 @@ var createMastraProject = async ({
   }
 };
 var create = async (args2) => {
+  if (args2.template !== void 0) {
+    await createFromTemplate(args2);
+    return;
+  }
   const { projectName } = await createMastraProject({
     projectName: args2?.projectName,
     createVersionTag: args2?.createVersionTag,
@@ -2300,11 +2474,65 @@ var postCreate = ({ 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) {
+      M.info("No template selected. Exiting.");
+      return;
+    }
+  } else if (args2.template) {
+    selectedTemplate = findTemplateByName(templates, args2.template);
+    if (!selectedTemplate) {
+      M.error(`Template "${args2.template}" not found. Available templates:`);
+      templates.forEach((t) => M.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 he({
+      message: "What is your project name?",
+      defaultValue: defaultName,
+      placeholder: defaultName
+    });
+    if (pD(response)) {
+      M.info("Project creation cancelled.");
+      return;
+    }
+    projectName = response;
+  }
+  try {
+    const analytics = getAnalytics();
+    if (analytics) ;
+    const projectPath = await cloneTemplate({
+      template: selectedTemplate,
+      projectName
+    });
+    await installDependencies(projectPath);
+    Me(`
+      ${color2.green("Mastra template installed!")}
+
+      Add the necessary environment 
+      variables in your ${color2.cyan(".env")} file
+      `);
+    postCreate({ projectName });
+  } catch (error) {
+    M.error(`Failed to create project from template: ${error instanceof Error ? error.message : "Unknown error"}`);
+    throw error;
+  }
+}
 
 async function 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 fsExtra.readJSON(pkgJsonPath);
   return content.version;
 }
@@ -2342,7 +2570,10 @@ program.version(`${version}`, "-v, --version").description(`create-mastra ${vers
 program.name("create-mastra").description("Create a new Mastra project").argument("[project-name]", "Directory name of the project").option(
   "-p, --project-name <string>",
   "Project name that will be used in package.json and as the project directory name."
-).option("--default", "Quick start with defaults(src, OpenAI, examples)").option("-c, --components <components>", "Comma-separated list of components (agents, tools, workflows)").option("-l, --llm <model-provider>", "Default model provider (openai, anthropic, groq, google, or cerebras)").option("-k, --llm-api-key <api-key>", "API key for the model provider").option("-e, --example", "Include example code").option("-n, --no-example", "Do not include example code").option("-t, --timeout [timeout]", "Configurable timeout for package installation, defaults to 60000 ms").option("-d, --dir <directory>", "Target directory for Mastra source code (default: src/)").option("-m, --mcp <mcp>", "MCP Server for code editor (cursor, cursor-global, windsurf, vscode)").action(async (projectNameArg, args) => {
+).option("--default", "Quick start with defaults(src, OpenAI, examples)").option("-c, --components <components>", "Comma-separated list of components (agents, tools, workflows)").option("-l, --llm <model-provider>", "Default model provider (openai, anthropic, groq, google, or cerebras)").option("-k, --llm-api-key <api-key>", "API key for the model provider").option("-e, --example", "Include example code").option("-n, --no-example", "Do not include example code").option("-t, --timeout [timeout]", "Configurable timeout for package installation, defaults to 60000 ms").option("-d, --dir <directory>", "Target directory for Mastra source code (default: src/)").option("-m, --mcp <mcp>", "MCP Server for code editor (cursor, cursor-global, windsurf, vscode)").option(
+  "--template [template-name]",
+  "Create project from a template (use template name or leave blank to select from list)"
+).action(async (projectNameArg, args) => {
   const projectName = projectNameArg || args.projectName;
   const timeout = args?.timeout ? args?.timeout === true ? 6e4 : parseInt(args?.timeout, 10) : void 0;
   if (args.default) {
@@ -2353,7 +2584,8 @@ program.name("create-mastra").description("Create a new Mastra project").argumen
       createVersionTag,
       timeout,
       mcpServer: args.mcp,
-      directory: "src/"
+      directory: "src/",
+      template: args.template
     });
     return;
   }
@@ -2366,7 +2598,8 @@ program.name("create-mastra").description("Create a new Mastra project").argumen
     timeout,
     projectName,
     directory: args.dir,
-    mcpServer: args.mcp
+    mcpServer: args.mcp,
+    template: args.template
   });
 });
 program.parse(process.argv);