create-mastra 1.2.0-alpha.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # create-mastra
 
+## 1.2.0
+
+## 1.2.0-alpha.1
+
 ## 1.2.0-alpha.0
 
 ## 1.1.0

package/dist/index.js

@@ -1245,7 +1245,7 @@ var PinoLogger = class _PinoLogger extends MastraLogger {
 };
 
 var package_default = {
-  version: "1.2.0-alpha.0"};
+  version: "1.2.0"};
 function getPackageManagerAddCommand(pm) {
   switch (pm) {
     case "npm":
@@ -2146,12 +2146,13 @@ var interactivePrompt = async (args = {}) => {
           const POPULAR_AGENTS = [
             { value: "claude-code", label: "Claude Code" },
             { value: "cursor", label: "Cursor" },
+            { value: "codex", label: "Codex" },
+            { value: "opencode", label: "OpenCode" },
             { 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" }
           ];
@@ -2162,7 +2163,6 @@ var interactivePrompt = async (args = {}) => {
             { 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" },
@@ -2190,7 +2190,8 @@ var interactivePrompt = async (args = {}) => {
           ];
           const initialSelection = await fe({
             message: "Select agent(s) to install skills for:",
-            options: [...POPULAR_AGENTS, { value: "__show_all__", label: "+ Show all agents (30 more)" }],
+            options: [...POPULAR_AGENTS, { value: "__show_all__", label: "+ Show all agents (29 more)" }],
+            initialValues: ["claude-code", "codex", "opencode", "cursor"],
             required: true
           });
           if (pD(initialSelection)) {
@@ -2312,6 +2313,146 @@ This will make the Mastra docs MCP server available in all Antigravity projects.
     mcpServer: configureMastraToolingForAgents?.mcpServer
   };
 };
+function generateAgentsMarkdown({ skills, mcpServer }) {
+  const hasSkills = skills && skills.length > 0;
+  const hasMcp = !!mcpServer;
+  let content = `# AGENTS.md
+
+This document provides guidance for AI coding agents working in this repository.
+
+## Project Overview
+
+This is a **Mastra** project written in TypeScript. Mastra is a framework for building AI-powered applications and agents with a modern TypeScript stack.
+
+## Commands
+
+Use these commands to interact with the project.
+
+### Installation
+
+\`\`\`bash
+npm install
+\`\`\`
+
+### Development
+
+Start the Mastra Studio at localhost:4111 by running the \`dev\` script:
+
+\`\`\`bash
+npm run dev
+\`\`\`
+
+### Build
+
+In order to build a production-ready server, run the \`build\` script:
+
+\`\`\`bash
+npm run build
+\`\`\`
+
+## Project Structure
+
+Folders organize your agent's resources, like agents, tools, and workflows.
+
+| Folder                 | Description                                                                                                                              |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| \`src/mastra\`           | Entry point for all Mastra-related code and configuration.                                                                               |
+| \`src/mastra/agents\`    | Define and configure your agents - their behavior, goals, and tools.                                                                     |
+| \`src/mastra/workflows\` | Define multi-step workflows that orchestrate agents and tools together.                                                                  |
+| \`src/mastra/tools\`     | Create reusable tools that your agents can call                                                                                          |
+| \`src/mastra/mcp\`       | (Optional) Implement custom MCP servers to share your tools with external agents                                                         |
+| \`src/mastra/scorers\`   | (Optional) Define scorers for evaluating agent performance over time                                                                     |
+| \`src/mastra/public\`    | (Optional) Contents are copied into the \`.build/output\` directory during the build process, making them available for serving at runtime |
+
+### Top-level files
+
+Top-level files define how your Mastra project is configured, built, and connected to its environment.
+
+| File                  | Description                                                                                                       |
+| --------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| \`src/mastra/index.ts\` | Central entry point where you configure and initialize Mastra.                                                    |
+| \`.env.example\`        | Template for environment variables - copy and rename to \`.env\` to add your secret [model provider](/models) keys. |
+| \`package.json\`        | Defines project metadata, dependencies, and available npm scripts.                                                |
+| \`tsconfig.json\`       | Configures TypeScript options such as path aliases, compiler settings, and build output.                          |
+
+`;
+  if (hasSkills) {
+    content += `## Mastra Skills
+
+Skills are modular capabilities that extend agent functionalities. They provide pre-built tools, integrations, and workflows that agents can leverage to accomplish tasks more effectively.
+
+This project has skills installed for the following agents:
+
+${skills.map(
+      (agent) => `- ${agent.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ")}`
+    ).join("\n")}
+
+### Using Skills
+
+Skills are automatically available to agents in your project once installed. Agents can access and use these skills without additional configuration.
+
+`;
+  }
+  if (hasMcp) {
+    const editorName = mcpServer === "cursor-global" ? "Cursor (global)" : mcpServer.charAt(0).toUpperCase() + mcpServer.slice(1);
+    content += `## MCP Docs Server
+
+This project has the Mastra MCP Docs Server configured for ${editorName}.
+
+### Using MCP Docs
+
+The MCP server provides embedded documentation access within your editor:
+
+1. The server was automatically configured during project creation
+2. Restart your editor to load the MCP server
+3. Use the Mastra docs tools in your editor to access:
+   - API references
+   - Code examples
+   - Integration guides
+
+Learn more in the [MCP Documentation](https://mastra.ai/docs/mcp/overview).
+
+`;
+  }
+  content += `## Resources
+
+- [Mastra Documentation](https://mastra.ai/llms.txt)
+- [Mastra .well-known skills discovery](https://mastra.ai/.well-known/skills/index.json)
+`;
+  return content;
+}
+function generateClaudeMarkdown({ mcpServer }) {
+  return `# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+This is a Mastra project - an AI framework for building agents, workflows, and tools. The project structure follows Mastra conventions with agents, tools, and workflows organized in the \`src/mastra/\` directory.
+
+For complete setup and usage instructions, see [AGENTS.md](./AGENTS.md), which includes:
+- Quick start commands
+- Project structure details
+- Mastra skills usage${mcpServer ? "\n- MCP Docs Server configuration" : ""}
+- Links to relevant documentation
+`;
+}
+async function writeAgentsMarkdown(options) {
+  const content = generateAgentsMarkdown(options);
+  const formattedContent = await prettier.format(content, {
+    parser: "markdown",
+    singleQuote: true
+  });
+  const filePath = path3.join(process.cwd(), "AGENTS.md");
+  await fs4.writeFile(filePath, formattedContent);
+}
+async function writeClaudeMarkdown(options) {
+  const content = generateClaudeMarkdown(options);
+  const formattedContent = await prettier.format(content, {
+    parser: "markdown",
+    singleQuote: true
+  });
+  const filePath = path3.join(process.cwd(), "CLAUDE.md");
+  await fs4.writeFile(filePath, formattedContent);
+}
 function getPackageManager() {
   const userAgent = process.env.npm_config_user_agent || "";
   const execPath = process.env.npm_execpath || "";
@@ -2650,6 +2791,22 @@ Warning: ${error instanceof Error ? error.message : "Unknown error"}`));
         versionTag
       });
     }
+    if (skills && skills.length > 0 || mcpServer) {
+      try {
+        await writeAgentsMarkdown({ skills, mcpServer });
+        const shouldWriteClaudeMd = skills?.includes("claude-code");
+        if (shouldWriteClaudeMd) {
+          await writeClaudeMarkdown({ skills, mcpServer });
+        }
+      } catch (error) {
+        console.warn(
+          color2.yellow(
+            `
+Warning: Failed to create agent guide files: ${error instanceof Error ? error.message : "Unknown error"}`
+          )
+        );
+      }
+    }
     if (initGit) {
       s.start("Initializing git repository");
       try {