create-mastra

# Create Mastra Skill

Complete guide for creating new Mastra AI agent projects. Includes both quickstart CLI method and detailed manual installation with full working code examples.

**Official documentation: [mastra.ai/docs](https://mastra.ai/docs)**

---

## Getting Started

Ask: **"How would you like to create your Mastra project?"**

1. **Quick Setup** - Copy and run: `npm create mastra@latest`
2. **Guided Setup** - I walk you through each step, you approve commands
3. **Automatic Setup** ⭐ - I create everything, just give me your API key

> **For AI agents:** The CLI is interactive. Use **Automatic Setup** — create files using the steps in "Automatic Setup / Manual Installation" below.

---

## Prerequisites

- An API key from a supported model provider (OpenAI, Anthropic, Google, etc.)

---

## Quick Setup (User runs CLI)

Create a new Mastra project with one command:

```bash
npm create mastra@latest
```

**Other package managers:**
```bash
pnpm create mastra@latest
yarn create mastra@latest
bun create mastra@latest
```

---

## CLI Flags

**Skip the example agent:**
```bash
npm create mastra@latest --no-example
```

**Use a specific template:**
```bash
npm create mastra@latest --template <template-name>
```

---

## Automatic Setup / Manual Installation

**Use this for Automatic Setup** (AI creates all files) or when you prefer manual control.

Follow these steps to create a complete Mastra project:

### Step 1: Create Project Directory
```bash
mkdir my-first-agent && cd my-first-agent
npm init -y
```

### Step 2: Install Dependencies

```bash
npm install -D typescript @types/node mastra@latest
npm install @mastra/core@latest zod@^4
```

### Step 3: Configure Package Scripts

Add to `package.json`:

```json
{
  "scripts": {
    "dev": "mastra dev",
    "build": "mastra build"
  }
}
```

### Step 4: Configure TypeScript

Create `tsconfig.json`:

```json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ES2022",
    "moduleResolution": "bundler"