Mastra Code

¿Qué es Mastra Code?

Mastra Code es un agente de IA para programar en la terminal, construido con los primitivos Harness, Agent y Memory de Mastra. Se ejecuta en tu terminal, se conecta a 70+ modelos de IA y soporta flujos de trabajo interactivos de programación como leer, buscar, editar y ejecutar código dentro de tu proyecto.

El propósito principal del agente es ayudarte con tareas de programación mediante una interfaz TUI (interfaz de usuario de terminal) en la terminal, modos estructurados y manejo de sesiones por proyecto. Está diseñado para organizar cómo piensa y actúa el agente, ya sea para una consulta rápida, una implementación planificada o un ciclo completo de compilación y pruebas.

Características principales

• Experiencia de interfaz de terminal (TUI): Ofrece una TUI pulida en tu terminal (componentes pi-tui) para un uso interactivo del agente, en lugar de una app web separada.
• Soporte multi-modelo (70+ modelos): Se conecta a 70+ modelos de IA y permite cambiar de modelo en medio de la conversación para flujos multi-modelo.
• Control de flujos por modos: Cambia entre modos Build, Plan y Fast para adaptar las respuestas del agente (p. ej., implementación vs. respuestas rápidas).
• Sesiones por proyecto y contexto persistente: Usa persistencia de hilos e historial de mensajes para organizar conversaciones por proyecto.
• Herramientas de programación en el agente: Incluye herramientas integradas para ver archivos, editar, buscar, comandos de shell y búsqueda web para tareas de programación de extremo a extremo.
• Comportamiento del agente configurable: Soporta configuración por proyecto, incluyendo servidores MCP, hooks, comandos personalizados, habilidades y ajustes de base de datos.
• Personalización programática: Extiende Mastra Code con modos, herramientas, subagentes y almacenamiento personalizados.

Cómo usar Mastra Code

1. Instala globalmente con uno de los comandos proporcionados (npm, pnpm o yarn), p. ej. npm install -g mastracode.
2. Navega a tu directorio de proyecto: cd your-project e inicia Mastra Code con mastracode.
3. Configura una clave API para tu proveedor preferido (ejemplo para Anthropic con export ANTHROPIC_API_KEY=...) o autentícate con /login (se menciona suscripción de Anthropic u OpenAI).
4. Envía un mensaje en la terminal; el agente responde con texto en streaming y puede leer, editar y ejecutar código en tu proyecto.
5. Usa comandos slash y atajos de teclado para gestionar sesiones, cambiar modelos y modos, y controlar la TUI (p. ej., /threads, /models, /mode, /cost, /login, /exit).

Casos de uso

• Asistente de programación diario: Haz preguntas sobre tu código, solicita ediciones, ejecuta pruebas y gestiona tareas de Git sin salir del flujo de terminal.
• Exploración de código y planificación de arquitectura: Usa el modo Plan para analizar arquitectura y generar un plan de implementación antes de escribir código.
• Consultas rápidas y cambios menores: Cambia al modo Fast para respuestas breves y ediciones menores con latencia mínima.
• Comparación multi-proveedor: Compara respuestas de diferentes modelos de IA a la misma pregunta de programación cambiando modelos en conversación.
• Gestión de sesiones y ajustes durante desarrollo: Usa comandos slash para iniciar hilos nuevos, listar hilos por proyecto, clonar hilos, ver uso de tokens y ajustar configuración/tema.

Preguntas frecuentes

¿Qué requisitos del sistema tiene Mastra Code?
Mastra Code requiere Node.js 22.13.0 o posterior.

¿Cómo autentico con un proveedor de IA?
Puedes configurar una clave API de entorno para tu proveedor (se muestra un ejemplo de Anthropic) o ejecutar /login para autenticarte con una suscripción de Anthropic u OpenAI.

¿Puedo cambiar modelos de IA y modos mientras uso el agente?
Sí. El agente ofrece comandos slash para seleccionar un modelo diferente y cambiar entre modos Build, Plan y Fast.

¿Cómo organiza Mastra Code las conversaciones?
Usa hilos por proyecto con historial de conversación persistente, lo que permite listar, clonar y gestionar hilos dentro de un proyecto.

¿Soporta Mastra Code personalizar herramientas o comportamiento del agente?
Sí. Puedes configurar funciones como servidores MCP, hooks, comandos personalizados, habilidades y ajustes de base de datos, y extender el agente con modos, herramientas, subagentes y almacenamiento personalizados.

Alternativas

• Herramientas de IA para programar integradas en IDE locales: Alternativas que se ejecutan dentro de editores/IDEs pueden ofrecer asistencia contextual en código, pero suelen centrarse en sugerencias inline en lugar de un flujo de trabajo de agente prioritario en terminal con modos explícitos.
• Chat LLM de terminal de propósito general con herramientas personalizadas: Un agente de chat en la terminal se puede extender con scripts para ediciones de archivos y ejecución de comandos, pero puede requerir más configuración para replicar las herramientas integradas de Mastra Code, el manejo de modos y la estructura de sesiones/hilos.
• Asistentes de programación basados en flujos de trabajo (estilo planificar/construir): Herramientas que enfatizan la planificación antes de la implementación pueden igualar la idea de “Modo Plan”; las diferencias suelen venir de cómo se manejan la ejecución de herramientas (edición/búsqueda/shell) y los hilos persistentes por proyecto.
• Frameworks de agentes para tareas de programación: Frameworks de agentes generales se pueden usar para construir un agente de programación con memoria y herramientas, pero Mastra Code empaqueta estos primitivos en una TUI de terminal lista para usar.