¿Qué es Mastra Code?

Mastra Code es un agente de codificación con IA avanzado, basado en terminal, diseñado para integrarse perfectamente en los flujos de trabajo de los desarrolladores. Construido sobre las robustas primitivas Harness, Agent y Memory de Mastra, lleva el poder de los modelos de lenguaje grandes directamente a su interfaz de línea de comandos. Actúa como un programador en pareja inteligente, capaz de comprender el contexto, ejecutar comandos y gestionar tareas de codificación complejas sin salir nunca del entorno de la terminal.

Este potente agente se conecta a más de 70 modelos de IA diferentes, lo que permite a los desarrolladores aprovechar el mejor modelo para tareas específicas o comparar resultados entre proveedores a mitad de la conversación. Su propósito principal es mejorar la productividad al proporcionar acceso inmediato a capacidades de lectura, búsqueda, edición y ejecución de código, todo gestionado a través de una interfaz de usuario de texto (TUI) intuitiva.

Características Principales

• Soporte Multi-Modelo: Se conecta y soporta más de 70 modelos de IA, lo que permite cambiar dinámicamente entre proveedores (como Anthropic u OpenAI) dentro de una sola sesión para un rendimiento óptimo o gestión de costes.
• Modos de Flujo de Trabajo: Ofrece modos operativos distintos: Build (desarrollo general), Plan (análisis y planificación arquitectónica) y Fast (consultas/ediciones rápidas de baja latencia), para adaptarse al enfoque actual del desarrollador.
• Herramientas Integradas: Proporciona herramientas integradas para tareas de desarrollo esenciales, incluyendo visualización y edición de archivos, búsqueda de código, ejecución de comandos shell y realización de búsquedas web.
• Contexto y Configuración Persistentes: Soporta hilos de conversación con ámbito de proyecto, servidores MCP, ganchos personalizados (hooks) y habilidades (skills). La persistencia de hilos garantiza la continuidad entre sesiones.
• Extensibilidad: Altamente personalizable, permite a los desarrolladores extender la funcionalidad programáticamente añadiendo modos personalizados, nuevas herramientas, subagentes y soluciones de almacenamiento alternativas.
• TUI Pulida: Presenta una interfaz de terminal moderna y receptiva construida con componentes pi-tui, ofreciendo una visibilidad clara de las operaciones, las salidas de las herramientas y el uso de tokens.

Cómo Usar Mastra Code

Comenzar con Mastra Code es sencillo y requiere Node.js (versión 22.13.0 o posterior) como requisito previo.

1. Instalación: Instale Mastra Code globalmente usando npm, yarn, bun, o ejecútelo directamente a través de npx o bun x:

npm install -g mastracode
# O
bun x mastracode

2. Inicialización: Navegue a su directorio de proyecto y inicie el agente:

cd su-proyecto
mastracode

3. Autenticación: Configure su clave API como variable de entorno (ej. export ANTHROPIC_API_KEY=...) o utilice el comando de barra /login para autenticarse a través de proveedores OAuth.

4. Interacción: Una vez autenticado, simplemente escriba su solicitud o comando en la TUI. El agente transmitirá las respuestas y puede leer, editar y ejecutar código activamente dentro del contexto de su proyecto. Utilice comandos de barra como /mode para cambiar de flujo de trabajo o /threads para gestionar conversaciones.

Casos de Uso

1. Refactorización y Depuración Diaria: Pregunte rápidamente al agente que explique funciones complejas, sugiera mejoras de refactorización, genere pruebas unitarias para módulos específicos o gestione operaciones Git simples directamente desde la terminal.
2. Planificación Arquitectónica: Utilice el Modo Plan para proporcionar al agente requisitos de alto nivel. Puede analizar la estructura de código existente, proponer planes de implementación detallados y describir los cambios de archivo necesarios antes de escribir cualquier código.
3. Cambio Rápido de Contexto: Al trabajar en un sistema heredado o una base de código desconocida, use Mastra Code para búsquedas rápidas (/mode Fast) para buscar instantáneamente documentación o encontrar dónde se inicializa una variable específica sin abrir múltiples archivos.
4. Pruebas de Comparación de Modelos: Los desarrolladores que trabajan en tareas críticas para el rendimiento pueden cambiar entre modelos a mitad de la conversación (ej. comparando la latencia de GPT-4o frente al razonamiento de Claude 3 Opus) para seleccionar la IA más adecuada y rentable para la tarea actual.
5. Integración de Herramientas Personalizadas: Los equipos pueden definir comandos de barra personalizados o subagentes adaptados a scripts de implementación internos o interacciones con bases de datos propietarias, integrando flujos de trabajo especializados directamente en las capacidades del agente.

Preguntas Frecuentes (FAQ)

P: ¿Cuáles son los requisitos mínimos del sistema para ejecutar Mastra Code? R: Mastra Code requiere Node.js versión 22.13.0 o posterior para ejecutarse eficazmente. Asegúrese de que su entorno cumpla con este requisito previo antes de la instalación.

P: ¿Cómo maneja Mastra Code el historial de conversación y el contexto? R: Utiliza LibSQL Storage para la persistencia de hilos, el historial de mensajes y el seguimiento del uso de tokens. Las conversaciones a menudo se delimitan al directorio del proyecto, asegurando que el agente recuerde el contexto relevante entre sesiones.

P: ¿Puedo definir mis propios comandos para el agente? R: Sí, Mastra Code es altamente extensible. Puede definir comandos de barra personalizados creando archivos markdown, lo que le permite adaptar la funcionalidad del agente a las necesidades específicas de su organización o herramientas internas.

P: ¿Qué sucede si el agente está ejecutando una operación larga? R: Puede interrumpir la operación actual utilizando el atajo de teclado estándar Ctrl+C. Esto le permite detener inmediatamente un comando shell en ejecución o un proceso de generación en curso.

P: ¿Cómo gestiono qué proveedor de IA estoy utilizando? R: Puede cambiar los modelos a mitad de la conversación utilizando el comando de barra /models, o estableciendo las variables de entorno de clave API relevantes. El agente soporta la autenticación con los principales proveedores como Anthropic y OpenAI.