create-mastra 0.0.0-toolOptionTypes-20250917085558 → 0.0.0-trace-timeline-update-20251121092347

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/CHANGELOG.md +427 -1
  2. package/README.md +10 -32
  3. package/dist/index.js +788 -540
  4. package/dist/index.js.map +1 -1
  5. package/dist/starter-files/tools.ts +2 -2
  6. package/dist/templates/dev.entry.js +4 -42
  7. package/package.json +13 -13
package/CHANGELOG.md CHANGED
@@ -1,9 +1,427 @@
1
1
  # create-mastra
2
2
 
3
- ## 0.0.0-toolOptionTypes-20250917085558
3
+ ## 0.0.0-trace-timeline-update-20251121092347
4
+
5
+ ### Major Changes
6
+
7
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
8
+
9
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
10
+
11
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
12
+
13
+ ### Patch Changes
14
+
15
+ - dependencies updates: ([#10111](https://github.com/mastra-ai/mastra/pull/10111))
16
+ - Updated dependency [`pino@^10.1.0` ↗︎](https://www.npmjs.com/package/pino/v/10.1.0) (from `^9.7.0`, in `dependencies`)
17
+
18
+ - dependencies updates: ([#9781](https://github.com/mastra-ai/mastra/pull/9781))
19
+ - Updated dependency [`posthog-node@^5.11.2` ↗︎](https://www.npmjs.com/package/posthog-node/v/5.11.2) (from `^4.18.0`, in `dependencies`)
20
+
21
+ - Update MainSidebar component to fit required changes in Cloud CTA link ([#9318](https://github.com/mastra-ai/mastra/pull/9318))
22
+
23
+ - Make MainSidebar toggle button sticky to bottom, always visible ([#9682](https://github.com/mastra-ai/mastra/pull/9682))
24
+
25
+ - fix: detect bun runtime and cleanup on failure ([#10242](https://github.com/mastra-ai/mastra/pull/10242))
26
+
27
+ - Fix scorer filtering for SpanScoring, add error and info message for user ([#10160](https://github.com/mastra-ai/mastra/pull/10160))
28
+
29
+ - Fix double scroll on agent chat container ([#10253](https://github.com/mastra-ai/mastra/pull/10253))
30
+
31
+ ## 1.0.0-beta.3
32
+
33
+ ### Patch Changes
34
+
35
+ - fix: detect bun runtime and cleanup on failure ([#10242](https://github.com/mastra-ai/mastra/pull/10242))
36
+
37
+ ## 1.0.0-beta.2
38
+
39
+ ### Patch Changes
40
+
41
+ - dependencies updates: ([#10111](https://github.com/mastra-ai/mastra/pull/10111))
42
+ - Updated dependency [`pino@^10.1.0` ↗︎](https://www.npmjs.com/package/pino/v/10.1.0) (from `^9.7.0`, in `dependencies`)
43
+
44
+ - dependencies updates: ([#9781](https://github.com/mastra-ai/mastra/pull/9781))
45
+ - Updated dependency [`posthog-node@^5.11.2` ↗︎](https://www.npmjs.com/package/posthog-node/v/5.11.2) (from `^4.18.0`, in `dependencies`)
46
+
47
+ - Fix scorer filtering for SpanScoring, add error and info message for user ([#10160](https://github.com/mastra-ai/mastra/pull/10160))
48
+
49
+ - Fix double scroll on agent chat container ([#10253](https://github.com/mastra-ai/mastra/pull/10253))
50
+
51
+ ## 1.0.0-beta.1
52
+
53
+ ### Patch Changes
54
+
55
+ - Make MainSidebar toggle button sticky to bottom, always visible ([#9682](https://github.com/mastra-ai/mastra/pull/9682))
56
+
57
+ ## 1.0.0-beta.0
58
+
59
+ ### Major Changes
60
+
61
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
62
+
63
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
64
+
65
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
66
+
67
+ ### Patch Changes
68
+
69
+ - Update MainSidebar component to fit required changes in Cloud CTA link ([#9318](https://github.com/mastra-ai/mastra/pull/9318))
70
+
71
+ ## 0.17.3
72
+
73
+ ## 0.17.3-alpha.0
74
+
75
+ ## 0.17.2
76
+
77
+ ## 0.17.2-alpha.0
78
+
79
+ ## 0.17.1
80
+
81
+ ### Patch Changes
82
+
83
+ - Add scorers to the default weather agent in the create command. ([#9042](https://github.com/mastra-ai/mastra/pull/9042))
84
+
85
+ - Fix tool result in playground ([#9087](https://github.com/mastra-ai/mastra/pull/9087))
86
+
87
+ ## 0.17.1-alpha.1
88
+
89
+ ### Patch Changes
90
+
91
+ - Add scorers to the default weather agent in the create command. ([#9042](https://github.com/mastra-ai/mastra/pull/9042))
92
+
93
+ - Fix tool result in playground ([#9087](https://github.com/mastra-ai/mastra/pull/9087))
94
+
95
+ ## 0.17.1-alpha.0
96
+
97
+ ## 0.17.0
98
+
99
+ ### Patch Changes
100
+
101
+ - Pin `@rollup/*` dependencies to fixed versions (instead of using `^`) to: ([#8900](https://github.com/mastra-ai/mastra/pull/8900))
102
+ - Hotfix a bug inside `@rollup/plugin-commonjs`
103
+ - Have more control over the versions in the future to not have breakages over night
104
+
105
+ ## 0.17.0-alpha.0
106
+
107
+ ### Patch Changes
108
+
109
+ - Pin `@rollup/*` dependencies to fixed versions (instead of using `^`) to: ([#8900](https://github.com/mastra-ai/mastra/pull/8900))
110
+ - Hotfix a bug inside `@rollup/plugin-commonjs`
111
+ - Have more control over the versions in the future to not have breakages over night
112
+
113
+ ## 0.16.0
114
+
115
+ ### Patch Changes
116
+
117
+ - Use model-router in create-mastra starter template ([#8631](https://github.com/mastra-ai/mastra/pull/8631))
118
+
119
+ - Fix auto tab for model picker in playground-ui, the UI no longer auto tabs to the next selector when selecting a model/provider. ([#8680](https://github.com/mastra-ai/mastra/pull/8680))
120
+
121
+ - Create unified Sidebar component to use on Playground and Cloud ([#8655](https://github.com/mastra-ai/mastra/pull/8655))
122
+
123
+ - Adds reset button to model picker to reset to original model set on the agent. ([#8633](https://github.com/mastra-ai/mastra/pull/8633))
124
+
125
+ - Use only zod validation in dynamic form ([#8802](https://github.com/mastra-ai/mastra/pull/8802))
126
+
127
+ - Add div wrapper around entity tables to fix table vertical position ([#8758](https://github.com/mastra-ai/mastra/pull/8758))
128
+
129
+ - Customize AITraces type to seamlessly work on Cloud too ([#8759](https://github.com/mastra-ai/mastra/pull/8759))
130
+
131
+ - Refactor EntryList component and Scorer and Observability pages ([#8652](https://github.com/mastra-ai/mastra/pull/8652))
132
+
133
+ - Stream finalResult from network loop ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
134
+
135
+ - Improve README ([#8819](https://github.com/mastra-ai/mastra/pull/8819))
136
+
137
+ ## 0.16.0-alpha.1
138
+
139
+ ### Patch Changes
140
+
141
+ - Fix auto tab for model picker in playground-ui, the UI no longer auto tabs to the next selector when selecting a model/provider. ([#8680](https://github.com/mastra-ai/mastra/pull/8680))
142
+
143
+ - Create unified Sidebar component to use on Playground and Cloud ([#8655](https://github.com/mastra-ai/mastra/pull/8655))
144
+
145
+ - Use only zod validation in dynamic form ([#8802](https://github.com/mastra-ai/mastra/pull/8802))
146
+
147
+ - Add div wrapper around entity tables to fix table vertical position ([#8758](https://github.com/mastra-ai/mastra/pull/8758))
148
+
149
+ - Customize AITraces type to seamlessly work on Cloud too ([#8759](https://github.com/mastra-ai/mastra/pull/8759))
150
+
151
+ - Stream finalResult from network loop ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
152
+
153
+ - Improve README ([#8819](https://github.com/mastra-ai/mastra/pull/8819))
154
+
155
+ ## 0.15.2-alpha.0
156
+
157
+ ### Patch Changes
158
+
159
+ - Use model-router in create-mastra starter template ([#8631](https://github.com/mastra-ai/mastra/pull/8631))
160
+
161
+ - Adds reset button to model picker to reset to original model set on the agent. ([#8633](https://github.com/mastra-ai/mastra/pull/8633))
162
+
163
+ - Refactor EntryList component and Scorer and Observability pages ([#8652](https://github.com/mastra-ai/mastra/pull/8652))
164
+
165
+ ## 0.15.1
166
+
167
+ ### Patch Changes
168
+
169
+ - Improve the overall flow of the `create-mastra` CLI by first asking all questions and then creating the project structure. If you skip entering an API key during the wizard, the `your-api-key` placeholder will now be added to an `.env.example` file instead of `.env`. ([#8603](https://github.com/mastra-ai/mastra/pull/8603))
170
+
171
+ ## 0.15.1-alpha.1
172
+
173
+ ## 0.15.1-alpha.0
174
+
175
+ ### Patch Changes
176
+
177
+ - Improve the overall flow of the `create-mastra` CLI by first asking all questions and then creating the project structure. If you skip entering an API key during the wizard, the `your-api-key` placeholder will now be added to an `.env.example` file instead of `.env`. ([#8603](https://github.com/mastra-ai/mastra/pull/8603))
178
+
179
+ ## 0.15.0
180
+
181
+ ### Patch Changes
182
+
183
+ - Mutable shared workflow run state ([#8545](https://github.com/mastra-ai/mastra/pull/8545))
184
+
185
+ - streamLegacy/generateLegacy clarification in playground ([#8468](https://github.com/mastra-ai/mastra/pull/8468))
186
+
187
+ - avoid refetching memory threads and messages on window focus ([#8519](https://github.com/mastra-ai/mastra/pull/8519))
188
+
189
+ - add tripwire reason in playground ([#8568](https://github.com/mastra-ai/mastra/pull/8568))
190
+
191
+ - Save waiting step status in snapshot ([#8576](https://github.com/mastra-ai/mastra/pull/8576))
192
+
193
+ - Added AI SDK provider packages to model router for anthropic/google/openai/openrouter/xai ([#8559](https://github.com/mastra-ai/mastra/pull/8559))
194
+
195
+ - Convert WorkflowWatchResult to WorkflowResult in workflow graph ([#8541](https://github.com/mastra-ai/mastra/pull/8541))
196
+
197
+ - Fixed an issue where model router was adding /chat/completions to API urls when it shouldn't. ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
198
+ fixed an issue with provider ID rendering in playground UI
199
+
200
+ - Fix useStreamWorkflow unmounting breaking stream call ([#8449](https://github.com/mastra-ai/mastra/pull/8449))
201
+
202
+ ## 0.15.0-alpha.3
203
+
204
+ ### Patch Changes
205
+
206
+ - Fixed an issue where model router was adding /chat/completions to API urls when it shouldn't. ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
207
+ fixed an issue with provider ID rendering in playground UI
208
+
209
+ ## 0.14.2-alpha.2
210
+
211
+ ### Patch Changes
212
+
213
+ - Added AI SDK provider packages to model router for anthropic/google/openai/openrouter/xai ([#8559](https://github.com/mastra-ai/mastra/pull/8559))
214
+
215
+ ## 0.14.2-alpha.1
4
216
 
5
217
  ### Patch Changes
6
218
 
219
+ - Mutable shared workflow run state ([#8545](https://github.com/mastra-ai/mastra/pull/8545))
220
+
221
+ - avoid refetching memory threads and messages on window focus ([#8519](https://github.com/mastra-ai/mastra/pull/8519))
222
+
223
+ - add tripwire reason in playground ([#8568](https://github.com/mastra-ai/mastra/pull/8568))
224
+
225
+ - Save waiting step status in snapshot ([#8576](https://github.com/mastra-ai/mastra/pull/8576))
226
+
227
+ - Convert WorkflowWatchResult to WorkflowResult in workflow graph ([#8541](https://github.com/mastra-ai/mastra/pull/8541))
228
+
229
+ ## 0.14.2-alpha.0
230
+
231
+ ### Patch Changes
232
+
233
+ - streamLegacy/generateLegacy clarification in playground ([#8468](https://github.com/mastra-ai/mastra/pull/8468))
234
+
235
+ - Fix useStreamWorkflow unmounting breaking stream call ([#8449](https://github.com/mastra-ai/mastra/pull/8449))
236
+
237
+ ## 0.14.1
238
+
239
+ ### Patch Changes
240
+
241
+ - Make init versions latest pkgs ([#8434](https://github.com/mastra-ai/mastra/pull/8434))
242
+
243
+ ## 0.14.1-alpha.0
244
+
245
+ ### Patch Changes
246
+
247
+ - Make init versions latest pkgs ([#8434](https://github.com/mastra-ai/mastra/pull/8434))
248
+
249
+ ## 0.14.0
250
+
251
+ ### Minor Changes
252
+
253
+ - Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
254
+
255
+ ### Patch Changes
256
+
257
+ - Remove log drains UI from the playground ([#8379](https://github.com/mastra-ai/mastra/pull/8379))
258
+
259
+ - add refetch interval to traces to make it feel "instant" ([#8386](https://github.com/mastra-ai/mastra/pull/8386))
260
+
261
+ - better memory message ([#8382](https://github.com/mastra-ai/mastra/pull/8382))
262
+
263
+ - fix codeblock line number color contrast for legacy traces ([#8385](https://github.com/mastra-ai/mastra/pull/8385))
264
+
265
+ - Model router documentation and playground UI improvements ([#8372](https://github.com/mastra-ai/mastra/pull/8372))
266
+
267
+ **Documentation generation (`@mastra/core`):**
268
+ - Fixed inverted dynamic model selection logic in provider examples
269
+ - Improved copy: replaced marketing language with action-oriented descriptions
270
+ - Added generated file comments with timestamps to all MDX outputs so maintainers know not to directly edit generated files
271
+
272
+ **Playground UI model picker (`@mastra/playground-ui`):**
273
+ - Fixed provider field clearing when typing in model input
274
+ - Added responsive layout (stacks on mobile, side-by-side on desktop)
275
+ - Improved general styling of provider/model pickers
276
+
277
+ **Environment variables (`@mastra/deployer`):**
278
+ - Properly handle array of env vars (e.g., NETLIFY_TOKEN, NETLIFY_SITE_ID)
279
+ - Added correct singular/plural handling for "environment variable(s)"
280
+
281
+ - show thread list in desc order ([#8381](https://github.com/mastra-ai/mastra/pull/8381))
282
+
283
+ - Fix an issue preventing showing working memory and semantic recall in the playground ([#8358](https://github.com/mastra-ai/mastra/pull/8358))
284
+
285
+ - Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
286
+
287
+ ## 0.14.0-alpha.0
288
+
289
+ ### Minor Changes
290
+
291
+ - Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
292
+
293
+ ### Patch Changes
294
+
295
+ - Remove log drains UI from the playground ([#8379](https://github.com/mastra-ai/mastra/pull/8379))
296
+
297
+ - add refetch interval to traces to make it feel "instant" ([#8386](https://github.com/mastra-ai/mastra/pull/8386))
298
+
299
+ - better memory message ([#8382](https://github.com/mastra-ai/mastra/pull/8382))
300
+
301
+ - fix codeblock line number color contrast for legacy traces ([#8385](https://github.com/mastra-ai/mastra/pull/8385))
302
+
303
+ - Model router documentation and playground UI improvements ([#8372](https://github.com/mastra-ai/mastra/pull/8372))
304
+
305
+ **Documentation generation (`@mastra/core`):**
306
+ - Fixed inverted dynamic model selection logic in provider examples
307
+ - Improved copy: replaced marketing language with action-oriented descriptions
308
+ - Added generated file comments with timestamps to all MDX outputs so maintainers know not to directly edit generated files
309
+
310
+ **Playground UI model picker (`@mastra/playground-ui`):**
311
+ - Fixed provider field clearing when typing in model input
312
+ - Added responsive layout (stacks on mobile, side-by-side on desktop)
313
+ - Improved general styling of provider/model pickers
314
+
315
+ **Environment variables (`@mastra/deployer`):**
316
+ - Properly handle array of env vars (e.g., NETLIFY_TOKEN, NETLIFY_SITE_ID)
317
+ - Added correct singular/plural handling for "environment variable(s)"
318
+
319
+ - show thread list in desc order ([#8381](https://github.com/mastra-ai/mastra/pull/8381))
320
+
321
+ - Fix an issue preventing showing working memory and semantic recall in the playground ([#8358](https://github.com/mastra-ai/mastra/pull/8358))
322
+
323
+ - Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
324
+
325
+ ## 0.13.4
326
+
327
+ ### Patch Changes
328
+
329
+ - disable network label when memory is not enabled OR the agent has no subagents ([#8341](https://github.com/mastra-ai/mastra/pull/8341))
330
+
331
+ - Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
332
+
333
+ ## 0.13.4-alpha.1
334
+
335
+ ### Patch Changes
336
+
337
+ - disable network label when memory is not enabled OR the agent has no subagents ([#8341](https://github.com/mastra-ai/mastra/pull/8341))
338
+
339
+ ## 0.13.4-alpha.0
340
+
341
+ ### Patch Changes
342
+
343
+ - Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
344
+
345
+ ## 0.13.3
346
+
347
+ ### Patch Changes
348
+
349
+ - Fixed an issue in playground where text-start/end parts were ignored in handleStreamChunk and tool ordering vs text wasn't retained ([#8234](https://github.com/mastra-ai/mastra/pull/8234))
350
+
351
+ - Add conditional chaining to scorer.agentNames return ([#8199](https://github.com/mastra-ai/mastra/pull/8199))
352
+
353
+ - Show model that worked when there are model fallbacks ([#8167](https://github.com/mastra-ai/mastra/pull/8167))
354
+
355
+ - Add types in the streamVNext codepath, fixes for various issues across multiple packages surfaced from type issues, align return types. ([#8010](https://github.com/mastra-ai/mastra/pull/8010))
356
+
357
+ - Add model fallbacks to playground ([#7427](https://github.com/mastra-ai/mastra/pull/7427))
358
+
359
+ ## 0.13.3-alpha.1
360
+
361
+ ### Patch Changes
362
+
363
+ - Fixed an issue in playground where text-start/end parts were ignored in handleStreamChunk and tool ordering vs text wasn't retained ([#8234](https://github.com/mastra-ai/mastra/pull/8234))
364
+
365
+ - Add conditional chaining to scorer.agentNames return ([#8199](https://github.com/mastra-ai/mastra/pull/8199))
366
+
367
+ - Show model that worked when there are model fallbacks ([#8167](https://github.com/mastra-ai/mastra/pull/8167))
368
+
369
+ ## 0.13.3-alpha.0
370
+
371
+ ### Patch Changes
372
+
373
+ - Add types in the streamVNext codepath, fixes for various issues across multiple packages surfaced from type issues, align return types. ([#8010](https://github.com/mastra-ai/mastra/pull/8010))
374
+
375
+ - Add model fallbacks to playground ([#7427](https://github.com/mastra-ai/mastra/pull/7427))
376
+
377
+ ## 0.13.2
378
+
379
+ ### Patch Changes
380
+
381
+ - dependencies updates: ([#8007](https://github.com/mastra-ai/mastra/pull/8007))
382
+ - Updated dependency [`fs-extra@^11.3.2` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.2) (from `^11.3.1`, in `dependencies`)
383
+
384
+ - Add model fallback handlers and apis ([#7378](https://github.com/mastra-ai/mastra/pull/7378))
385
+
386
+ - Fix DateTimePicker style issue ([#8106](https://github.com/mastra-ai/mastra/pull/8106))
387
+
388
+ - Fix getting tool link path from agent in playground ui tools page ([#8135](https://github.com/mastra-ai/mastra/pull/8135))
389
+
390
+ ## 0.13.2-alpha.4
391
+
392
+ ### Patch Changes
393
+
394
+ - Fix getting tool link path from agent in playground ui tools page ([#8135](https://github.com/mastra-ai/mastra/pull/8135))
395
+
396
+ ## 0.13.2-alpha.3
397
+
398
+ ### Patch Changes
399
+
400
+ - Add model fallback handlers and apis ([#7378](https://github.com/mastra-ai/mastra/pull/7378))
401
+
402
+ - Fix DateTimePicker style issue ([#8106](https://github.com/mastra-ai/mastra/pull/8106))
403
+
404
+ ## 0.13.2-alpha.2
405
+
406
+ ## 0.13.2-alpha.1
407
+
408
+ ### Patch Changes
409
+
410
+ - dependencies updates: ([#8007](https://github.com/mastra-ai/mastra/pull/8007))
411
+ - Updated dependency [`fs-extra@^11.3.2` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.2) (from `^11.3.1`, in `dependencies`)
412
+
413
+ ## 0.13.2-alpha.0
414
+
415
+ ## 0.13.1
416
+
417
+ ## 0.13.1-alpha.0
418
+
419
+ ## 0.13.0
420
+
421
+ ### Patch Changes
422
+
423
+ - clean up console logs in monorepo ([#7926](https://github.com/mastra-ai/mastra/pull/7926))
424
+
7
425
  - Update peerdep of @mastra/core ([#7619](https://github.com/mastra-ai/mastra/pull/7619))
8
426
 
9
427
  - fix minor playground stuff for observability ([#7765](https://github.com/mastra-ai/mastra/pull/7765))
@@ -12,6 +430,14 @@
12
430
 
13
431
  - Playground ui -pass runtimeContext to client SDK get methods ([#7767](https://github.com/mastra-ai/mastra/pull/7767))
14
432
 
433
+ ## 0.13.0-alpha.5
434
+
435
+ ## 0.13.0-alpha.4
436
+
437
+ ### Patch Changes
438
+
439
+ - clean up console logs in monorepo ([#7926](https://github.com/mastra-ai/mastra/pull/7926))
440
+
15
441
  ## 0.13.0-alpha.3
16
442
 
17
443
  ## 0.13.0-alpha.2
package/README.md CHANGED
@@ -1,9 +1,16 @@
1
- # Create Mastra
1
+ # create-mastra
2
2
 
3
- The easiest way to get started with Mastra is by using `create-mastra`. This CLI tool enables you to quickly start building a new Mastra application, with everything set up for you.
3
+ Mastra is a framework for building AI-powered applications and agents with a modern TypeScript stack.
4
+
5
+ It includes everything you need to go from early prototypes to production-ready applications. Mastra integrates with frontend and backend frameworks like React, Next.js, and Node, or you can deploy it anywhere as a standalone server. It's the easiest way to build, tune, and scale reliable AI products.
6
+
7
+ `create-mastra` is the **recommended** way to get started with Mastra. This CLI tool enables you to quickly start building a new Mastra application, with everything set up for you.
4
8
 
5
9
  ## Usage
6
10
 
11
+ > [!IMPORTANT]
12
+ > Make sure that you have Node.js 20 or later installed on your system.
13
+
7
14
  Using npm:
8
15
 
9
16
  ```bash
@@ -22,33 +29,4 @@ Using pnpm:
22
29
  pnpm create mastra
23
30
  ```
24
31
 
25
- ## Options
26
-
27
- - `--default` - Quick start with defaults (src directory, OpenAI, no examples)
28
- - `-c, --components <components>` - Comma-separated list of components (agents, tools, workflows)
29
- - `-l, --llm <model-provider>` - Default model provider (openai, anthropic, groq, google, or cerebras)
30
- - `-e, --example` - Include example code
31
-
32
- ## Examples
33
-
34
- Create a new project with default settings
35
- npx create-mastra@latest --default
36
- Create a project with specific components and LLM provider
37
- npx create-mastra@latest -c agents,tools -l anthropic
38
- Create a project with example code
39
- npx create-mastra@latest --example
40
-
41
- ## What's included?
42
-
43
- The generated project will have:
44
-
45
- - A configured Mastra setup in the src directory
46
- - Selected components (agents, tools, workflows)
47
- - Environment configuration for your chosen LLM provider
48
- - TypeScript configuration
49
- - Example code (if selected)
50
-
51
- ## System Requirements
52
-
53
- - Node.js 20 or later
54
- - MacOS, Windows, and Linux are supported
32
+ Learn more about `create-mastra` in the [CLI reference documentation](https://mastra.ai/reference/cli/create-mastra).