create-mastra 0.0.0-feat-mcp-embedded-docs-tools-clean-20260108124346 → 0.0.0-feat-cli-skills-installation-20260202141803

package/CHANGELOG.md

@@ -1,6 +1,30 @@
 # create-mastra
 
-## 0.0.0-feat-mcp-embedded-docs-tools-clean-20260108124346
+## 0.0.0-feat-cli-skills-installation-20260202141803
+
+## 1.1.0
+
+### Patch Changes
+
+- fix workflow run input caching bug in studio UI ([#11784](https://github.com/mastra-ai/mastra/pull/11784))
+
+## 1.1.0-alpha.3
+
+## 1.1.0-alpha.2
+
+## 1.1.0-alpha.1
+
+## 1.1.0-alpha.0
+
+### Patch Changes
+
+- fix workflow run input caching bug in studio UI ([#11784](https://github.com/mastra-ai/mastra/pull/11784))
+
+## 1.0.1
+
+## 1.0.1-alpha.0
+
+## 1.0.0
 
 ### Major Changes
 
@@ -24,11 +48,16 @@
   + const stream = await run.stream({ inputData: { ... } });
   ```
 
+- Replace deprecated client.getTraces with a client.listTraces ([#11711](https://github.com/mastra-ai/mastra/pull/11711))
+
 - Fix select options overflow when list is long by adding maximum height ([#10813](https://github.com/mastra-ai/mastra/pull/10813))
 
 - dependencies updates: ([#10111](https://github.com/mastra-ai/mastra/pull/10111))
   - Updated dependency [`pino@^10.1.0` ↗︎](https://www.npmjs.com/package/pino/v/10.1.0) (from `^9.7.0`, in `dependencies`)
 
+- dependencies updates: ([#11642](https://github.com/mastra-ai/mastra/pull/11642))
+  - Updated dependency [`fs-extra@^11.3.3` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.3) (from `^11.3.2`, in `dependencies`)
+
 - dependencies updates: ([#9781](https://github.com/mastra-ai/mastra/pull/9781))
   - Updated dependency [`posthog-node@^5.11.2` ↗︎](https://www.npmjs.com/package/posthog-node/v/5.11.2) (from `^4.18.0`, in `dependencies`)
 
@@ -51,6 +80,12 @@
 
 - Make MainSidebar toggle button sticky to bottom, always visible ([#9682](https://github.com/mastra-ai/mastra/pull/9682))
 
+- Add human-in-the-loop (HITL) support to agent networks ([#11678](https://github.com/mastra-ai/mastra/pull/11678))
+  - Add suspend/resume capabilities to agent network
+  - Enable auto-resume for suspended network execution via `autoResumeSuspendedTools`
+
+  `agent.resumeNetwork`, `agent.approveNetworkToolCall`, `agent.declineNetworkToolCall`
+
 - Fix peer dependency conflicts in browsing-agent template. Updated template dependencies to align with @browserbasehq/stagehand@2.5.6 requirements: ([#11346](https://github.com/mastra-ai/mastra/pull/11346))
   - Updated `dotenv` from `^17.2.1` to `^16.4.5`
   - Updated `zod` from `^3.25.76` to `^3.25.67`
@@ -80,6 +115,8 @@
 
 - Add initial state input to workflow form in studio ([#11560](https://github.com/mastra-ai/mastra/pull/11560))
 
+- Make initialState optional in studio ([#11744](https://github.com/mastra-ai/mastra/pull/11744))
+
 - Fix discriminatedUnion schema information lost when json schema is converted to zod ([#10500](https://github.com/mastra-ai/mastra/pull/10500))
 
 - Move useScorers down to trace page to trigger it once for all trace spans ([#10985](https://github.com/mastra-ai/mastra/pull/10985))
@@ -98,6 +135,35 @@
 
 - fix isTopLevelSpan value definition on SpanScoring to properly recognize lack of span?.parentSpanId value (null or empty string) ([#11083](https://github.com/mastra-ai/mastra/pull/11083))
 
+## 1.0.0-beta.19
+
+## 1.0.0-beta.18
+
+## 1.0.0-beta.17
+
+## 1.0.0-beta.16
+
+## 1.0.0-beta.15
+
+### Patch Changes
+
+- Add human-in-the-loop (HITL) support to agent networks ([#11678](https://github.com/mastra-ai/mastra/pull/11678))
+  - Add suspend/resume capabilities to agent network
+  - Enable auto-resume for suspended network execution via `autoResumeSuspendedTools`
+
+  `agent.resumeNetwork`, `agent.approveNetworkToolCall`, `agent.declineNetworkToolCall`
+
+## 1.0.0-beta.14
+
+### Patch Changes
+
+- Replace deprecated client.getTraces with a client.listTraces ([#11711](https://github.com/mastra-ai/mastra/pull/11711))
+
+- dependencies updates: ([#11642](https://github.com/mastra-ai/mastra/pull/11642))
+  - Updated dependency [`fs-extra@^11.3.3` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.3) (from `^11.3.2`, in `dependencies`)
+
+- Make initialState optional in studio ([#11744](https://github.com/mastra-ai/mastra/pull/11744))
+
 ## 1.0.0-beta.13
 
 ### Patch Changes

package/README.md

@@ -9,7 +9,7 @@ It includes everything you need to go from early prototypes to production-ready
 ## Usage
 
 > [!IMPORTANT]
-> Make sure that you have Node.js 20 or later installed on your system.
+> Make sure that you have Node.js 22.13.0 or later installed on your system.
 
 Using npm:
 

package/dist/index.js

@@ -22,8 +22,8 @@ import fsExtra$1 from 'fs-extra';
 import pino from 'pino';
 import pretty from 'pino-pretty';
 
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = path3.dirname(__filename);
+var __filename$1 = fileURLToPath(import.meta.url);
+var __dirname$1 = path3.dirname(__filename$1);
 var analyticsInstance = null;
 function getAnalytics() {
   return analyticsInstance;
@@ -39,7 +39,7 @@ var PosthogAnalytics = class {
     host = "https://app.posthog.com"
   }) {
     this.version = version;
-    const cliConfigPath = path3.join(__dirname, "mastra-cli.json");
+    const cliConfigPath = path3.join(__dirname$1, "mastra-cli.json");
     if (existsSync(cliConfigPath)) {
       try {
         const { distinctId, sessionId } = JSON.parse(readFileSync(cliConfigPath, "utf-8"));
@@ -67,7 +67,7 @@ var PosthogAnalytics = class {
   }
   writeCliConfig({ distinctId, sessionId }) {
     try {
-      writeFileSync(path3.join(__dirname, "mastra-cli.json"), JSON.stringify({ distinctId, sessionId }));
+      writeFileSync(path3.join(__dirname$1, "mastra-cli.json"), JSON.stringify({ distinctId, sessionId }));
     } catch {
     }
   }
@@ -384,9 +384,9 @@ function DD({onlyFirst:e=false}={}){const t=["[\\u001B\\u009B][[\\]()#;?]*(?:(?:
 `).length-1;this.output.write(srcExports.cursor.move(-999,u*-1));}render(){const u=Y$1(this._render(this)??"",process.stdout.columns,{hard:true});if(u!==this._prevFrame){if(this.state==="initial")this.output.write(srcExports.cursor.hide);else {const t=BD(this._prevFrame,u);if(this.restoreCursor(),t&&t?.length===1){const F=t[0];this.output.write(srcExports.cursor.move(0,F)),this.output.write(srcExports.erase.lines(1));const s=u.split(`
 `);this.output.write(s[F]),this._prevFrame=u,this.output.write(srcExports.cursor.move(0,s.length-F-1));return}if(t&&t?.length>1){const F=t[0];this.output.write(srcExports.cursor.move(0,F)),this.output.write(srcExports.erase.down());const s=u.split(`
 `).slice(F);this.output.write(s.join(`
-`)),this._prevFrame=u;return}this.output.write(srcExports.erase.down());}this.output.write(u),this.state==="initial"&&(this.state="active"),this._prevFrame=u;}}}class dD extends x{get cursor(){return this.value?0:1}get _value(){return this.cursor===0}constructor(u){super(u,false),this.value=!!u.initialValue,this.on("value",()=>{this.value=this._value;}),this.on("confirm",t=>{this.output.write(srcExports.cursor.move(0,-1)),this.value=t,this.state="submit",this.close();}),this.on("cursor",()=>{this.value=!this.value;});}}var OD=Object.defineProperty,PD=(e,u,t)=>u in e?OD(e,u,{enumerable:true,configurable:true,writable:true,value:t}):e[u]=t,J=(e,u,t)=>(PD(e,typeof u!="symbol"?u+"":u,t),t);class LD extends x{constructor(u){super(u,false),J(this,"options"),J(this,"cursor",0),this.options=u.options,this.cursor=this.options.findIndex(({value:t})=>t===u.initialValue),this.cursor===-1&&(this.cursor=0),this.changeValue(),this.on("cursor",t=>{switch(t){case "left":case "up":this.cursor=this.cursor===0?this.options.length-1:this.cursor-1;break;case "down":case "right":this.cursor=this.cursor===this.options.length-1?0:this.cursor+1;break}this.changeValue();});}get _value(){return this.options[this.cursor]}changeValue(){this.value=this._value.value;}}class RD extends x{get valueWithCursor(){if(this.state==="submit")return this.value;if(this.cursor>=this.value.length)return `${this.value}\u2588`;const u=this.value.slice(0,this.cursor),[t,...F]=this.value.slice(this.cursor);return `${u}${color2.inverse(t)}${F.join("")}`}get cursor(){return this._cursor}constructor(u){super(u),this.on("finalize",()=>{this.value||(this.value=u.defaultValue);});}}
+`)),this._prevFrame=u;return}this.output.write(srcExports.erase.down());}this.output.write(u),this.state==="initial"&&(this.state="active"),this._prevFrame=u;}}}class dD extends x{get cursor(){return this.value?0:1}get _value(){return this.cursor===0}constructor(u){super(u,false),this.value=!!u.initialValue,this.on("value",()=>{this.value=this._value;}),this.on("confirm",t=>{this.output.write(srcExports.cursor.move(0,-1)),this.value=t,this.state="submit",this.close();}),this.on("cursor",()=>{this.value=!this.value;});}}var kD=Object.defineProperty,$D=(e,u,t)=>u in e?kD(e,u,{enumerable:true,configurable:true,writable:true,value:t}):e[u]=t,H=(e,u,t)=>($D(e,typeof u!="symbol"?u+"":u,t),t);let SD=class extends x{constructor(u){super(u,false),H(this,"options"),H(this,"cursor",0),this.options=u.options,this.value=[...u.initialValues??[]],this.cursor=Math.max(this.options.findIndex(({value:t})=>t===u.cursorAt),0),this.on("key",t=>{t==="a"&&this.toggleAll();}),this.on("cursor",t=>{switch(t){case "left":case "up":this.cursor=this.cursor===0?this.options.length-1:this.cursor-1;break;case "down":case "right":this.cursor=this.cursor===this.options.length-1?0:this.cursor+1;break;case "space":this.toggleValue();break}});}get _value(){return this.options[this.cursor].value}toggleAll(){const u=this.value.length===this.options.length;this.value=u?[]:this.options.map(t=>t.value);}toggleValue(){const u=this.value.includes(this._value);this.value=u?this.value.filter(t=>t!==this._value):[...this.value,this._value];}};var OD=Object.defineProperty,PD=(e,u,t)=>u in e?OD(e,u,{enumerable:true,configurable:true,writable:true,value:t}):e[u]=t,J=(e,u,t)=>(PD(e,typeof u!="symbol"?u+"":u,t),t);class LD extends x{constructor(u){super(u,false),J(this,"options"),J(this,"cursor",0),this.options=u.options,this.cursor=this.options.findIndex(({value:t})=>t===u.initialValue),this.cursor===-1&&(this.cursor=0),this.changeValue(),this.on("cursor",t=>{switch(t){case "left":case "up":this.cursor=this.cursor===0?this.options.length-1:this.cursor-1;break;case "down":case "right":this.cursor=this.cursor===this.options.length-1?0:this.cursor+1;break}this.changeValue();});}get _value(){return this.options[this.cursor]}changeValue(){this.value=this._value.value;}}class RD extends x{get valueWithCursor(){if(this.state==="submit")return this.value;if(this.cursor>=this.value.length)return `${this.value}\u2588`;const u=this.value.slice(0,this.cursor),[t,...F]=this.value.slice(this.cursor);return `${u}${color2.inverse(t)}${F.join("")}`}get cursor(){return this._cursor}constructor(u){super(u),this.on("finalize",()=>{this.value||(this.value=u.defaultValue);});}}
 
-function ce(){return y$1.platform!=="win32"?y$1.env.TERM!=="linux":!!y$1.env.CI||!!y$1.env.WT_SESSION||!!y$1.env.TERMINUS_SUBLIME||y$1.env.ConEmuTask==="{cmd::Cmder}"||y$1.env.TERM_PROGRAM==="Terminus-Sublime"||y$1.env.TERM_PROGRAM==="vscode"||y$1.env.TERM==="xterm-256color"||y$1.env.TERM==="alacritty"||y$1.env.TERMINAL_EMULATOR==="JetBrains-JediTerm"}const V=ce(),u=(t,n)=>V?t:n,le=u("\u25C6","*"),L=u("\u25A0","x"),W=u("\u25B2","x"),C=u("\u25C7","o"),ue=u("\u250C","T"),o=u("\u2502","|"),d=u("\u2514","\u2014"),k=u("\u25CF",">"),P=u("\u25CB"," "),_=u("\u2500","-"),me=u("\u256E","+"),de=u("\u251C","+"),pe=u("\u256F","+"),q=u("\u25CF","\u2022"),D=u("\u25C6","*"),U=u("\u25B2","!"),K=u("\u25A0","x"),b=t=>{switch(t){case "initial":case "active":return color2.cyan(le);case "cancel":return color2.red(L);case "error":return color2.yellow(W);case "submit":return color2.green(C)}},G=t=>{const{cursor:n,options:r,style:i}=t,s=t.maxItems??Number.POSITIVE_INFINITY,c=Math.max(process.stdout.rows-4,0),a=Math.min(c,Math.max(s,5));let l=0;n>=l+a-3?l=Math.max(Math.min(n-a+3,r.length-a),0):n<l+2&&(l=Math.max(n-2,0));const $=a<r.length&&l>0,g=a<r.length&&l+a<r.length;return r.slice(l,l+a).map((p,v,f)=>{const j=v===0&&$,E=v===f.length-1&&g;return j||E?color2.dim("..."):i(p,v+l===n)})},he=t=>new RD({validate:t.validate,placeholder:t.placeholder,defaultValue:t.defaultValue,initialValue:t.initialValue,render(){const n=`${color2.gray(o)}
+function ce(){return y$1.platform!=="win32"?y$1.env.TERM!=="linux":!!y$1.env.CI||!!y$1.env.WT_SESSION||!!y$1.env.TERMINUS_SUBLIME||y$1.env.ConEmuTask==="{cmd::Cmder}"||y$1.env.TERM_PROGRAM==="Terminus-Sublime"||y$1.env.TERM_PROGRAM==="vscode"||y$1.env.TERM==="xterm-256color"||y$1.env.TERM==="alacritty"||y$1.env.TERMINAL_EMULATOR==="JetBrains-JediTerm"}const V=ce(),u=(t,n)=>V?t:n,le=u("\u25C6","*"),L=u("\u25A0","x"),W=u("\u25B2","x"),C=u("\u25C7","o"),ue=u("\u250C","T"),o=u("\u2502","|"),d=u("\u2514","\u2014"),k=u("\u25CF",">"),P=u("\u25CB"," "),A=u("\u25FB","[\u2022]"),T=u("\u25FC","[+]"),F=u("\u25FB","[ ]"),_=u("\u2500","-"),me=u("\u256E","+"),de=u("\u251C","+"),pe=u("\u256F","+"),q=u("\u25CF","\u2022"),D=u("\u25C6","*"),U=u("\u25B2","!"),K=u("\u25A0","x"),b=t=>{switch(t){case "initial":case "active":return color2.cyan(le);case "cancel":return color2.red(L);case "error":return color2.yellow(W);case "submit":return color2.green(C)}},G=t=>{const{cursor:n,options:r,style:i}=t,s=t.maxItems??Number.POSITIVE_INFINITY,c=Math.max(process.stdout.rows-4,0),a=Math.min(c,Math.max(s,5));let l=0;n>=l+a-3?l=Math.max(Math.min(n-a+3,r.length-a),0):n<l+2&&(l=Math.max(n-2,0));const $=a<r.length&&l>0,g=a<r.length&&l+a<r.length;return r.slice(l,l+a).map((p,v,f)=>{const j=v===0&&$,E=v===f.length-1&&g;return j||E?color2.dim("..."):i(p,v+l===n)})},he=t=>new RD({validate:t.validate,placeholder:t.placeholder,defaultValue:t.defaultValue,initialValue:t.initialValue,render(){const n=`${color2.gray(o)}
 ${b(this.state)}  ${t.message}
 `,r=t.placeholder?color2.inverse(t.placeholder[0])+color2.dim(t.placeholder.slice(1)):color2.inverse(color2.hidden("_")),i=this.value?this.valueWithCursor:r;switch(this.state){case "error":return `${n.trim()}
 ${color2.yellow(o)}  ${i}
@@ -405,6 +405,18 @@ ${b(this.state)}  ${t.message}
 ${color2.gray(o)}`;default:return `${r}${color2.cyan(o)}  ${G({cursor:this.cursor,options:this.options,maxItems:t.maxItems,style:(i,s)=>n(i,s?"active":"inactive")}).join(`
 ${color2.cyan(o)}  `)}
 ${color2.cyan(d)}
+`}}}).prompt()},fe=t=>{const n=(r,i)=>{const s=r.label??String(r.value);return i==="active"?`${color2.cyan(A)} ${s} ${r.hint?color2.dim(`(${r.hint})`):""}`:i==="selected"?`${color2.green(T)} ${color2.dim(s)} ${r.hint?color2.dim(`(${r.hint})`):""}`:i==="cancelled"?`${color2.strikethrough(color2.dim(s))}`:i==="active-selected"?`${color2.green(T)} ${s} ${r.hint?color2.dim(`(${r.hint})`):""}`:i==="submitted"?`${color2.dim(s)}`:`${color2.dim(F)} ${color2.dim(s)}`};return new SD({options:t.options,initialValues:t.initialValues,required:t.required??true,cursorAt:t.cursorAt,validate(r){if(this.required&&r.length===0)return `Please select at least one option.
+${color2.reset(color2.dim(`Press ${color2.gray(color2.bgWhite(color2.inverse(" space ")))} to select, ${color2.gray(color2.bgWhite(color2.inverse(" enter ")))} to submit`))}`},render(){const r=`${color2.gray(o)}
+${b(this.state)}  ${t.message}
+`,i=(s,c)=>{const a=this.value.includes(s.value);return c&&a?n(s,"active-selected"):a?n(s,"selected"):n(s,c?"active":"inactive")};switch(this.state){case "submit":return `${r}${color2.gray(o)}  ${this.options.filter(({value:s})=>this.value.includes(s)).map(s=>n(s,"submitted")).join(color2.dim(", "))||color2.dim("none")}`;case "cancel":{const s=this.options.filter(({value:c})=>this.value.includes(c)).map(c=>n(c,"cancelled")).join(color2.dim(", "));return `${r}${color2.gray(o)}  ${s.trim()?`${s}
+${color2.gray(o)}`:""}`}case "error":{const s=this.error.split(`
+`).map((c,a)=>a===0?`${color2.yellow(d)}  ${color2.yellow(c)}`:`   ${c}`).join(`
+`);return `${r+color2.yellow(o)}  ${G({options:this.options,cursor:this.cursor,maxItems:t.maxItems,style:i}).join(`
+${color2.yellow(o)}  `)}
+${s}
+`}default:return `${r}${color2.cyan(o)}  ${G({options:this.options,cursor:this.cursor,maxItems:t.maxItems,style:i}).join(`
+${color2.cyan(o)}  `)}
+${color2.cyan(d)}
 `}}}).prompt()},Me=(t="",n="")=>{const r=`
 ${t}
 `.split(`
@@ -1233,7 +1245,7 @@ var PinoLogger = class _PinoLogger extends MastraLogger {
 };
 
 var package_default = {
-  version: "1.0.0-beta.13"};
+  version: "1.1.0"};
 function getPackageManagerAddCommand(pm) {
   switch (pm) {
     case "npm":
@@ -1254,7 +1266,7 @@ var DepsService = class {
     this.packageManager = this.getPackageManager();
   }
   findLockFile(dir) {
-    const lockFiles = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock", "bun.lock"];
+    const lockFiles = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock", "bun.lock", "bun.lockb"];
     for (const file of lockFiles) {
       if (fs3__default__default.existsSync(path3.join(dir, file))) {
         return file;
@@ -1276,6 +1288,7 @@ var DepsService = class {
       case "yarn.lock":
         return "yarn";
       case "bun.lock":
+      case "bun.lockb":
         return "bun";
       default:
         return "npm";
@@ -1288,7 +1301,7 @@ var DepsService = class {
     return execa(`${pm} ${installCommand} ${packageList}`, {
       all: true,
       shell: true,
-      stdio: "inherit"
+      stdio: "pipe"
     });
   }
   async checkDependencies(dependencies) {
@@ -1985,7 +1998,7 @@ export const mastra = new Mastra()
 import { Mastra } from '@mastra/core/mastra';
 import { PinoLogger } from '@mastra/loggers';
 import { LibSQLStore } from '@mastra/libsql';
-import { Observability } from '@mastra/observability';
+import { Observability, DefaultExporter, CloudExporter, SensitiveDataFilter } from '@mastra/observability';
 ${addWorkflow ? `import { weatherWorkflow } from './workflows/weather-workflow';` : ""}
 ${addAgent ? `import { weatherAgent } from './agents/weather-agent';` : ""}
 ${addScorers ? `import { toolCallAppropriatenessScorer, completenessScorer, translationScorer } from './scorers/weather-scorer';` : ""}
@@ -1994,16 +2007,26 @@ export const mastra = new Mastra({
   ${filteredExports.join("\n  ")}
   storage: new LibSQLStore({
     id: "mastra-storage",
-    // stores observability, scores, ... into memory storage, if it needs to persist, change to file:../mastra.db
-    url: ":memory:",
+    // stores observability, scores, ... into persistent file storage
+    url: "file:./mastra.db",
   }),
   logger: new PinoLogger({
     name: 'Mastra',
     level: 'info',
   }),
   observability: new Observability({
-    // Enables DefaultExporter and CloudExporter for tracing
-    default: { enabled: true },
+    configs: {
+      default: {
+        serviceName: 'mastra',
+        exporters: [
+          new DefaultExporter(), // Persists traces to storage for Mastra Studio
+          new CloudExporter(), // Sends traces to Mastra Cloud (if MASTRA_CLOUD_ACCESS_TOKEN is set)
+        ],
+        spanOutputProcessors: [
+          new SensitiveDataFilter(), // Redacts sensitive data like passwords, tokens, keys
+        ],
+      },
+    },
   }),
 });
 `
@@ -2106,80 +2129,160 @@ var interactivePrompt = async (args = {}) => {
         }
         return void 0;
       },
-      configureEditorWithDocsMCP: async () => {
-        const editor = await ve({
-          message: `Make your IDE into a Mastra expert? (Installs Mastra's MCP server)`,
+      configureMastraToolingForCodingAgents: async () => {
+        if (skip?.configureMastraToolingForCodingAgents) return void 0;
+        const choice = await ve({
+          message: `Configure Mastra tooling for coding agents?`,
           options: [
-            { value: "skip", label: "Skip for now", hint: "default" },
-            {
-              value: "cursor",
-              label: "Cursor (project only)"
-            },
-            {
-              value: "cursor-global",
-              label: "Cursor (global, all projects)"
-            },
-            {
-              value: "windsurf",
-              label: "Windsurf"
-            },
-            {
-              value: "vscode",
-              label: "VSCode"
-            },
-            {
-              value: "antigravity",
-              label: "Antigravity"
-            }
-          ]
+            { value: "skills", label: "Skills - Mastra agent skills", hint: "recommended" },
+            { value: "mcp", label: "MCP Docs - IDE integration" }
+          ],
+          initialValue: "skills"
         });
-        if (editor === `skip`) return void 0;
-        if (editor === `cursor`) {
-          M.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 confirm3 = await ve({
-            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" },
-              { value: "skip", label: "No, skip for now" }
-            ]
+        if (choice === "skills") {
+          const POPULAR_AGENTS = [
+            { value: "claude-code", label: "Claude Code" },
+            { value: "cursor", label: "Cursor" },
+            { value: "windsurf", label: "Windsurf" },
+            { value: "github-copilot", label: "GitHub Copilot" },
+            { value: "cline", label: "Cline" },
+            { value: "continue", label: "Continue" },
+            { value: "gemini-cli", label: "Gemini CLI" },
+            { value: "opencode", label: "OpenCode" },
+            { value: "replit", label: "Replit" },
+            { value: "roo", label: "Roo Code" }
+          ];
+          const ALL_AGENTS = [
+            ...POPULAR_AGENTS,
+            { value: "adal", label: "AdaL" },
+            { value: "amp", label: "Amp" },
+            { value: "antigravity", label: "Antigravity" },
+            { value: "augment", label: "Augment" },
+            { value: "codebuddy", label: "CodeBuddy" },
+            { value: "codex", label: "Codex" },
+            { value: "command-code", label: "Command Code" },
+            { value: "crush", label: "Crush" },
+            { value: "droid", label: "Droid" },
+            { value: "goose", label: "Goose" },
+            { value: "iflow-cli", label: "iFlow CLI" },
+            { value: "junie", label: "Junie" },
+            { value: "kilo", label: "Kilo Code" },
+            { value: "kimi-cli", label: "Kimi Code CLI" },
+            { value: "kiro-cli", label: "Kiro CLI" },
+            { value: "kode", label: "Kode" },
+            { value: "mcpjam", label: "MCPJam" },
+            { value: "mistral-vibe", label: "Mistral Vibe" },
+            { value: "mux", label: "Mux" },
+            { value: "neovate", label: "Neovate" },
+            { value: "openclaude", label: "OpenClaude IDE" },
+            { value: "openclaw", label: "OpenClaw" },
+            { value: "openhands", label: "OpenHands" },
+            { value: "pi", label: "Pi" },
+            { value: "pochi", label: "Pochi" },
+            { value: "qoder", label: "Qoder" },
+            { value: "qwen-code", label: "Qwen Code" },
+            { value: "trae", label: "Trae" },
+            { value: "trae-cn", label: "Trae CN" },
+            { value: "zencoder", label: "Zencoder" }
+          ];
+          const initialSelection = await fe({
+            message: "Select agent(s) to install skills for:",
+            options: [...POPULAR_AGENTS, { value: "__show_all__", label: "+ Show all agents (30 more)" }],
+            required: true
           });
-          if (confirm3 !== `yes`) {
+          if (pD(initialSelection)) {
             return void 0;
           }
+          let selectedAgents = initialSelection;
+          if (selectedAgents.includes("__show_all__")) {
+            const preSelected = selectedAgents.filter((a) => a !== "__show_all__");
+            const fullSelection = await fe({
+              message: "Select agent(s) to install skills for:",
+              options: ALL_AGENTS,
+              initialValues: preSelected,
+              required: true
+            });
+            if (pD(fullSelection)) {
+              return void 0;
+            }
+            selectedAgents = fullSelection;
+          }
+          return { type: "skills", agents: selectedAgents };
         }
-        if (editor === `windsurf`) {
-          const confirm3 = await ve({
-            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.`,
+        if (choice === "mcp") {
+          const editor = await ve({
+            message: `Which editor?`,
             options: [
-              { value: "yes", label: "Yes, I understand" },
-              { value: "skip", label: "No, skip for now" }
+              {
+                value: "cursor",
+                label: "Cursor (project only)"
+              },
+              {
+                value: "cursor-global",
+                label: "Cursor (global, all projects)"
+              },
+              {
+                value: "windsurf",
+                label: "Windsurf"
+              },
+              {
+                value: "vscode",
+                label: "VSCode"
+              },
+              {
+                value: "antigravity",
+                label: "Antigravity"
+              }
             ]
           });
-          if (confirm3 !== `yes`) {
-            return void 0;
+          if (editor === `cursor`) {
+            M.message(
+              `
+Note: you will need to go into Cursor Settings -> MCP Settings and manually enable the installed Mastra MCP server.
+`
+            );
           }
-        }
-        if (editor === `antigravity`) {
-          const confirm3 = await ve({
-            message: `Antigravity only supports a global MCP config (at ${antigravityGlobalMCPConfigPath}). Is it ok to add/update that global config?
+          if (editor === `cursor-global`) {
+            const confirm3 = await ve({
+              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" },
+                { value: "no", label: "No, cancel" }
+              ]
+            });
+            if (confirm3 !== `yes`) {
+              return void 0;
+            }
+          }
+          if (editor === `windsurf`) {
+            const confirm3 = await ve({
+              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: [
+                { value: "yes", label: "Yes, I understand" },
+                { value: "no", label: "No, cancel" }
+              ]
+            });
+            if (confirm3 !== `yes`) {
+              return void 0;
+            }
+          }
+          if (editor === `antigravity`) {
+            const confirm3 = await ve({
+              message: `Antigravity only supports a global MCP config (at ${antigravityGlobalMCPConfigPath}). Is it ok to add/update that global config?
 This will make the Mastra docs MCP server available in all Antigravity projects.`,
-            options: [
-              { value: "yes", label: "Yes, I understand" },
-              { value: "skip", label: "No, skip for now" }
-            ]
-          });
-          if (confirm3 !== `yes`) {
-            return void 0;
+              options: [
+                { value: "yes", label: "Yes, I understand" },
+                { value: "no", label: "No, cancel" }
+              ]
+            });
+            if (confirm3 !== `yes`) {
+              return void 0;
+            }
           }
+          return editor;
         }
-        return editor;
+        return void 0;
       },
       initGit: async () => {
         if (skip?.gitInit) return false;
@@ -2424,6 +2527,26 @@ function findTemplateByName(templates, templateName) {
 function getDefaultProjectName(template) {
   return template.slug.replace(/^template-/, "");
 }
+async function installMastraSkills({
+  directory,
+  agents
+}) {
+  try {
+    const args = ["skills", "add", "mastra-ai/skills", "--agent", ...agents, "-y"];
+    await execa("npx", args, {
+      cwd: directory,
+      stdio: "pipe"
+      // Hide verbose output
+    });
+    return { success: true, agents };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : "Unknown error",
+      agents
+    };
+  }
+}
 var s = Y();
 var init = async ({
   directory = "src/",
@@ -2432,6 +2555,7 @@ var init = async ({
   llmApiKey,
   addExample = false,
   configureEditorWithDocsMCP,
+  configureMastraToolingForCodingAgents,
   versionTag,
   initGit = false
 }) => {
@@ -2484,22 +2608,39 @@ var init = async ({
       }
     }
     const key = await getAPIKey(llmProvider || "openai");
-    if (configureEditorWithDocsMCP) {
+    s.stop("Mastra initialized");
+    if (configureMastraToolingForCodingAgents && typeof configureMastraToolingForCodingAgents === "object" && "type" in configureMastraToolingForCodingAgents && configureMastraToolingForCodingAgents.type === "skills") {
+      s.start("Installing Mastra agent skills");
+      const skillsResult = await installMastraSkills({
+        directory: process.cwd(),
+        agents: configureMastraToolingForCodingAgents.agents
+      });
+      if (skillsResult.success) {
+        const agentNames = skillsResult.agents.map((agent) => {
+          return agent.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+        }).join(", ");
+        s.stop(`Mastra agent skills installed (in ${agentNames})`);
+      } else {
+        s.stop("Skills installation failed");
+        console.warn(color2.yellow(`
+Warning: ${skillsResult.error}`));
+      }
+    }
+    const mcpEditor = configureMastraToolingForCodingAgents && typeof configureMastraToolingForCodingAgents === "string" && ["cursor", "cursor-global", "windsurf", "vscode", "antigravity"].includes(configureMastraToolingForCodingAgents) ? configureMastraToolingForCodingAgents : configureEditorWithDocsMCP;
+    if (mcpEditor) {
       await installMastraDocsMCPServer({
-        editor: configureEditorWithDocsMCP,
+        editor: mcpEditor,
         directory: process.cwd(),
         versionTag
       });
     }
-    s.stop();
     if (initGit) {
-      const s2 = Y();
+      s.start("Initializing git repository");
       try {
-        s2.start("Initializing git repository");
         await gitInit({ cwd: process.cwd() });
-        s2.stop("Git repository initialized");
+        s.stop("Git repository initialized");
       } catch {
-        s2.stop();
+        s.stop();
       }
     }
     if (!llmApiKey) {
@@ -2573,6 +2714,42 @@ async function initializePackageJson(pm) {
   };
   await fs4.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));
 }
+var writeReadmeFile = async ({ dirPath, projectName }) => {
+  const packageManager = getPackageManager();
+  const readmePath = path3.join(dirPath, "README.md");
+  const content = `# ${projectName}
+
+Welcome to your new [Mastra](https://mastra.ai/) project! We're excited to see what you'll build.
+
+## Getting Started
+
+Start the development server:
+
+\`\`\`shell
+${packageManager} run dev
+\`\`\`
+
+Open [http://localhost:4111](http://localhost:4111) in your browser to access [Mastra Studio](https://mastra.ai/docs/getting-started/studio). It provides an interactive UI for building and testing your agents, along with a REST API that exposes your Mastra application as a local service. This lets you start building without worrying about integration right away.
+
+You can start editing files inside the \`src/mastra\` directory. The development server will automatically reload whenever you make changes.
+
+## Learn more
+
+To learn more about Mastra, visit our [documentation](https://mastra.ai/docs/). Your bootstrapped project includes example code for [agents](https://mastra.ai/docs/agents/overview), [tools](https://mastra.ai/docs/agents/using-tools), [workflows](https://mastra.ai/docs/workflows/overview), [scorers](https://mastra.ai/docs/evals/overview), and [observability](https://mastra.ai/docs/observability/overview).
+
+If you're new to AI agents, check out our [course](https://mastra.ai/course) and [YouTube videos](https://youtube.com/@mastra-ai). You can also join our [Discord](https://discord.gg/BTYqqHKUrf) community to get help and share your projects.
+
+## Deploy on Mastra Cloud
+
+[Mastra Cloud](https://cloud.mastra.ai/) gives you a serverless agent environment with atomic deployments. Access your agents from anywhere and monitor performance. Make sure they don't go off the rails with evals and tracing.
+
+Check out the [deployment guide](https://mastra.ai/docs/deployment/overview) for more details.`;
+  const formattedContent = await prettier.format(content, {
+    parser: "markdown",
+    singleQuote: true
+  });
+  await fs4.writeFile(readmePath, formattedContent);
+};
 async function installMastraDependency(pm, dependency, versionTag, isDev, timeout) {
   let installCommand = getPackageManagerAddCommand(pm);
   if (isDev) {
@@ -2601,6 +2778,7 @@ var createMastraProject = async ({
   timeout,
   llmProvider,
   llmApiKey,
+  skills,
   needsInteractive
 }) => {
   Ie(color2.inverse(" Mastra Create "));
@@ -2623,7 +2801,11 @@ var createMastraProject = async ({
   if (needsInteractive) {
     result = await interactivePrompt({
       options: { showBanner: false },
-      skip: { llmProvider: llmProvider !== void 0, llmApiKey: llmApiKey !== void 0 }
+      skip: {
+        llmProvider: llmProvider !== void 0,
+        llmApiKey: llmApiKey !== void 0,
+        configureMastraToolingForCodingAgents: skills !== void 0 && skills.length > 0
+      }
     });
   }
   const s2 = Y();
@@ -2655,6 +2837,7 @@ var createMastraProject = async ({
         build: "mastra build",
         start: "mastra start"
       });
+      await writeReadmeFile({ dirPath: process.cwd(), projectName });
     } catch (error) {
       throw new Error(
         `Failed to initialize project structure: ${error instanceof Error ? error.message : "Unknown error"}`
@@ -2759,6 +2942,7 @@ var create = async (args) => {
     timeout: args?.timeout,
     llmProvider: args?.llmProvider,
     llmApiKey: args?.llmApiKey,
+    skills: args?.skills,
     needsInteractive
   });
   const directory = args.directory || "src/";
@@ -2768,6 +2952,8 @@ var create = async (args) => {
       llmApiKey: result?.llmApiKey,
       components: ["agents", "tools", "workflows", "scorers"],
       addExample: true,
+      configureMastraToolingForCodingAgents: result?.configureMastraToolingForCodingAgents || (args.skills && args.skills.length > 0 ? { type: "skills", agents: args.skills } : void 0),
+      configureEditorWithDocsMCP: void 0,
       versionTag: args.createVersionTag
     });
     postCreate({ projectName });
@@ -2780,6 +2966,7 @@ var create = async (args) => {
     llmProvider,
     addExample,
     llmApiKey,
+    configureMastraToolingForCodingAgents: args.skills && args.skills.length > 0 ? { type: "skills", agents: args.skills } : void 0,
     configureEditorWithDocsMCP: args.mcpServer,
     versionTag: args.createVersionTag
   });