Mastra Code

O que é o Mastra Code?

Mastra Code é um agente de IA para codificação no terminal, criado com os primitivos Harness, Agent e Memory da Mastra. Ele roda no seu terminal, conecta a 70+ modelos de IA e suporta fluxos de codificação interativos, como ler, buscar, editar e executar código dentro do seu projeto.

O propósito principal do agente é ajudá-lo a realizar tarefas de codificação usando uma TUI (interface de usuário de terminal) no terminal, modos estruturados e gerenciamento de sessões com escopo de projeto. Ele é projetado para organizar como o agente pensa e age — seja para uma consulta rápida, uma implementação planejada ou um ciclo completo de build e teste.

Principais Recursos

• Experiência de Terminal UI (TUI): Fornece uma TUI polida no seu terminal (componentes pi-tui) para uso interativo do agente, em vez de um app web separado.
• Suporte a múltiplos modelos (70+ modelos): Conecta a 70+ modelos de IA e permite trocar modelos durante a conversa para fluxos multi-modelo.
• Controle de fluxo baseado em modos: Alterne entre os modos Build, Plan e Fast para adequar as respostas do agente (ex.: implementação vs. respostas rápidas).
• Sessões com escopo de projeto e contexto persistente: Usa persistência de threads e histórico de mensagens para organizar conversas por projeto.
• Ferramentas de codificação no agente: Inclui ferramentas integradas para visualização de arquivos, edição, busca, comandos shell e busca web para suportar tarefas de codificação de ponta a ponta.
• Comportamento do agente configurável: Suporta configuração com escopo de projeto, incluindo servidores MCP, hooks, comandos personalizados, skills e configurações de banco de dados.
• Customização programática: Estenda o Mastra Code com modos personalizados, ferramentas, subagentes e armazenamento.

Como Usar o Mastra Code

1. Instale globalmente usando um dos comandos fornecidos (npm, pnpm ou yarn), ex.: npm install -g mastracode.
2. Navegue até o diretório do seu projeto: cd your-project e inicie o Mastra Code com mastracode.
3. Defina uma chave de API para o provedor preferido (exemplo para Anthropic via export ANTHROPIC_API_KEY=...) ou autentique usando /login (assinatura Anthropic ou OpenAI mencionada).
4. Envie uma mensagem no terminal; o agente responde com texto em streaming e pode ler, editar e executar código no seu projeto.
5. Use comandos slash e atalhos de teclado para gerenciar sessões, trocar modelos e modos, e controlar a TUI (ex.: /threads, /models, /mode, /cost, /login, /exit).

Casos de Uso

• Assistente de codificação no dia a dia: Faça perguntas sobre seu codebase, solicite edições, execute testes e gerencie tarefas Git mantendo-se no mesmo fluxo de terminal.
• Exploração de código e planejamento de arquitetura: Use o modo Plan para analisar arquitetura e gerar um plano de implementação antes de escrever código.
• Consultas rápidas e pequenas alterações: Alterne para o modo Fast para respostas breves e edições menores com latência mínima.
• Comparação multi-provedor: Compare como diferentes modelos de IA respondem à mesma pergunta de codificação trocando modelos durante a conversa.
• Gerenciamento de sessões e configurações durante o desenvolvimento: Use comandos slash para iniciar novas threads de conversa, listar threads por projeto, clonar threads, ver uso de tokens e ajustar configurações/tema.

FAQ

Quais são os requisitos de sistema do Mastra Code?
Mastra Code requer Node.js 22.13.0 ou superior.

Como autentico com um provedor de IA?
Você pode definir uma variável de ambiente com a chave de API do seu provedor (exemplo com Anthropic mostrado) ou execute /login para autenticar com uma assinatura Anthropic ou OpenAI.

Posso trocar modelos de IA e modos enquanto uso o agente?
Sim. O agente oferece comandos slash para selecionar um modelo de IA diferente e alternar entre os modos Build, Plan e Fast.

Como o Mastra Code organiza as conversas?
Ele usa threads com escopo de projeto com histórico de conversa persistente, permitindo listar, clonar e gerenciar threads dentro de um projeto.

O Mastra Code suporta customização de ferramentas ou comportamento do agente?
Sim. Você pode configurar recursos como servidores MCP, hooks, comandos personalizados, skills e configurações de banco de dados, e estender o agente com modos, ferramentas, subagentes e armazenamento personalizados.

Alternativas

• Ferramentas de IA para codificação integradas a IDEs locais: Alternativas que rodam dentro de editores/IDEs podem oferecer assistência contextual ao código, mas geralmente focam em sugestões inline em vez de um fluxo de trabalho de agente priorizando terminal com modos explícitos.
• Chat LLM de terminal de uso geral com ferramentas personalizadas: Um agente de chat no terminal pode ser estendido com scripts para edições de arquivos e execução de comandos, mas você pode precisar de mais configuração para replicar as ferramentas integradas do Mastra Code, manuseio de modos e estrutura de sessão/thread.
• Assistentes de codificação baseados em fluxo de trabalho (estilo plan/build): Ferramentas que enfatizam planejamento antes da implementação podem corresponder à ideia do “Modo Plan”; as diferenças geralmente vêm de como a execução de ferramentas (edição/busca/shell) e threads de projeto persistentes são tratadas.
• Frameworks de agentes para tarefas de codificação: Frameworks de agentes gerais podem ser usados para construir um agente de codificação com memória e ferramentas, mas o Mastra Code empacota esses primitivos em um TUI de terminal pronto para rodar.