Mastra Code

Mastra Code is a terminal-based AI coding agent built on Mastra's Harness, Agent, and Memory primitives. It runs in your terminal, connects to 70+ AI models, and provides built-in tools for reading, searching, editing, and executing code. The tool supports multiple operational modes, persistent conversation threads, MCP server integration, and full programmatic extensibility via its createMastraCode() API.

• Build, Plan, and Fast Modes: Switch between modes to match your workflow — Build for active coding, Plan for architecture analysis, and Fast for quick lookups with minimal latency.
• 70+ AI Model Support: Connect to models from Anthropic, OpenAI, Google, and other providers; switch models mid-conversation using the /models slash command.
• Built-in Coding Tools: File viewing, editing, searching, shell command execution, and web search are all available out of the box.
• MCP Server Integration: Configure and connect to Model Context Protocol servers for extended tool capabilities within your project.
• Persistent Thread Management: Project-scoped conversation threads are stored via LibSQL, preserving message history and token usage across sessions.
• Observational Memory: Background observer and reflector models automatically summarize and reflect on long conversations to maintain context.
• Custom Modes and Tools: Extend Mastra Code programmatically by defining custom modes, tools, subagents, and storage backends using the createMastraCode() factory function.
• Permission Controls: Fine-grained per-category and per-tool approval policies let you control which operations require confirmation (read, edit, execute, MCP).
• Slash Commands: Manage sessions, switch models, view token costs, authenticate with providers, and more using built-in / commands.
• Remote Storage Support: Connect to remote LibSQL (Turso) or PostgreSQL databases for shared or cloud-backed thread persistence.
• Embeddable API: Use createMastraCode() and MastraTUI to embed the agent in custom applications or build entirely new TUI experiences.

To get started, install globally with npm install -g mastracode, navigate to your project directory, run mastracode, and set an API key for your preferred AI provider.