The Mastra CLI lets you initialize a new project, spin up a local dev server, and deploy it to serverless platforms like Vercel and Cloudflare Workers.

npm i -g mastra

# Initialize a new project
mastra init

Mastra's data syncing infrastructure is designed for Next.js sites running on serverless hosting providers like Vercel or Netlify.

Logs are stored in Upstash.

mastra init is used for initializing a new project.

This creates a mastra directory under src containing an index.ts entrypoint and an agent directory containing two sample agents.

project-root/
├── src/
   ├── app/
   └── mastra/
       ├── agents/
       │   └── agents.ts
       └── index.ts

mastra dev

This spins up a local development server that hosts REST endpoints for all agents and workflows. It also has a chat interface for testing them.

The server is useful for testing and developing agents, workflows, and integrations without needing to deploy your application.

The server is available at http://localhost:3000.

mastra build

This command builds your Mastra project for deployment to different environments. The build process:

1. Reads your Mastra configuration
2. Generates optimized files for your target environment
3. Outputs them to a build directory

Options:

--dir     Directory containing Mastra files (default: src/mastra)

Example usage:

# Build using default directory
mastra build

# Build from custom directory
mastra build --dir path/to/mastra

The build output is determined by your Mastra instance's deployer configuration:

const mastra = new Mastra({
  deployer: {
    type: 'HONO', // Target environment (HONO, EXPRESS, NEXT)
    // Environment-specific options
  },
});

mastra lint

Validates your Mastra project structure and code.

Options:

--root    Path to your root folder
--tools   Comma-separated list of paths to tool files to include

Example usage:

# Lint default directory
mastra lint

This CLI collects anonymous usage data (no personal/sensitive info) to help improve Mastra. This includes:

• Commands used
• Command execution time
• Error occurrences
• System information (OS, Node version)

To opt-out:

1. Add MASTRA_TELEMETRY_DISABLED=1 to commands

1. clone the repo
2. Run pnpm i to install deps