|
History
|
||
|---|---|---|
| .. | ||
| e2e | ||
| scripts | ||
| src | ||
| CHANGELOG.md | ||
| e2e-list.ts | ||
| lint-staged.config.js | ||
| oxlint.config.ts | ||
| package.json | ||
| README.md | ||
| tsconfig.build.json | ||
| tsconfig.json | ||
| tsdown.config.ts | ||
| turbo.json | ||
| VERIFICATION.md | ||
| vitest.config.ts | ||
Mastra Code
Mastra Code is a terminal-based AI coding agent distributed as the mastracode package. It combines persistent project-scoped conversations, multiple model providers, coding tools, goals, plugins, dynamic workflows, and Observational Memory so long-running work does not depend on context-window compaction.
Installation
Mastra Code requires Node.js 22.19.0 or later. Install the CLI globally:
npm install -g mastracode
To use the programmatic API or build a custom TUI, install it as a project dependency instead:
npm install mastracode
Usage
Start Mastra Code from the project you want it to work in:
cd your-project
mastracode
Or run it without a global installation:
npx mastracode
On first launch, the onboarding wizard connects a model provider, configures main model packs, and asks whether tool calls should require approval. Run /setup to repeat onboarding later.
Documentation
- Get started with Mastra Code
- Configure providers, storage, hooks, MCP servers, and diagnostics
- Use Build, Plan, and Fast modes
- Run persistent goals
- Use Mastra Code in headless and CI environments
- Customize or embed Mastra Code
- Mastra Code API reference
Changelog
See the package changelog for version history and release notes.
Support
We have an open community Discord. Come and say hello and let us know if you have any questions or need any help getting things running.