Mastra Code

Mastra Code: El Agente de Codificación Basado en IA para tu Terminal

En el panorama actual del desarrollo de software, la eficiencia es fundamental. Mastra Code surge como una solución avanzada para programadores que prefieren la velocidad y potencia de la línea de comandos. Este agente de IA para terminal está construido meticulosamente sobre las primitivas de Mastra: Harness, Agent y Memory, proporcionando una experiencia de codificación fluida y conectada.

Con Mastra Code, los desarrolladores tienen a su disposición un asistente capaz de conectarse a más de 70 modelos de IA diferentes, ofreciendo herramientas integradas para leer, buscar, editar y ejecutar código de manera local y segura.

¿Qué es Mastra Code?

Mastra Code es un agente de codificación basado en la terminal (TUI) que actúa como un puente inteligente entre tu código fuente y la inteligencia artificial. A diferencia de otros asistentes, Mastra Code se ejecuta directamente en tu terminal y utiliza una arquitectura de cuatro capas para garantizar persistencia, ejecución de herramientas dinámicas y gestión de estados.

Arquitectura de Mastra Code

Este ecosistema se basa en cuatro pilares tecnológicos:

1. TUI: Una interfaz de terminal moderna utilizando componentes pi-tui.
2. Harness: Gestiona los modos, la persistencia de hilos, el sistema de eventos y el estado.
3. Mastra Agent: Se encarga de la selección dinámica de modelos, ejecución de herramientas, integración de memoria y subagentes.
4. LibSQL Storage: Almacenamiento especializado para la persistencia de hilos, historial de mensajes, rastreo de uso de tokens y memoria observacional.

Características Principales de Mastra Code

El potencial de Mastra Code reside en su versatilidad y su capacidad de personalización. Estas son sus funciones más destacadas:

• Conectividad de Modelos: Acceso a más de 70 modelos de IA líderes en la industria.
• Herramientas Integradas: Capacidades nativas para visualización de archivos, edición, búsqueda, comandos de shell y búsqueda web.
• Gestión de Modos: Permite cambiar entre diferentes flujos de trabajo según la necesidad del momento.
• Configuración Avanzada: Soporte para servidores MCP, ganchos (hooks), comandos personalizados y habilidades (skills).
• Extensibilidad: Puedes extender Mastra Code programáticamente añadiendo modos personalizados, subagentes y almacenamiento propio.
• Comandos de Barra Diagonal (Slash Commands): Comandos intuitivos como /new, /models o /diff para gestionar sesiones con facilidad.

Casos de Uso (Use Case)

Mastra Code se adapta a diversas situaciones del ciclo de vida del desarrollo:

Codificación del Día a Día

Utiliza Mastra Code para realizar preguntas directas sobre tu base de código, aplicar ediciones rápidas, ejecutar pruebas unitarias y gestionar tus repositorios de Git sin cambiar de ventana.

Exploración de Código y Arquitectura

Mediante el Plan Mode, los desarrolladores pueden analizar arquitecturas complejas y crear planes de implementación detallados antes de escribir una sola línea de código.

Consultas Rápidas

El Fast Mode es ideal para obtener respuestas breves y realizar ediciones menores con una latencia mínima, manteniendo el flujo de trabajo sin interrupciones.

Workflows Multi-modelo

Una de las ventajas competitivas de Mastra Code es la capacidad de comparar respuestas de diferentes proveedores de IA (como Anthropic o OpenAI) cambiando de modelo en medio de una conversación.

Cómo Usar Mastra Code

Requisitos Previos

Para ejecutar Mastra Code, es necesario tener instalado Node.js 22.13.0 o una versión posterior.

Instalación

Puedes instalarlo globalmente en tu sistema utilizando tu gestor de paquetes preferido:

• npm: npm install -g mastracode
• pnpm: pnpm add -g mastracode
• Yarn / Bun: Soportados para la instalación global.

También puedes ejecutarlo sin instalación previa usando npx: npx mastracode

Inicio Rápido

1. Navega al directorio de tu proyecto: cd tu-proyecto.
2. Inicia la herramienta: mastracode.
3. Configura tu clave de API (ej. export ANTHROPIC_API_KEY=sk-...) o utiliza el comando /login para autenticarte.
4. Escribe un mensaje y presiona Enter para que el agente comience a interactuar con tu código.

Atajos de Teclado Útiles

• Ctrl+C: Interrumpir la operación actual.
• Ctrl+D: Salir (cuando el editor está vacío).
• Ctrl+T: Alternar la visibilidad de los bloques de pensamiento (thinking blocks).
• Ctrl+E: Expandir o colapsar todas las salidas de herramientas.
• Ctrl+F: Enviar un mensaje de seguimiento mientras el agente está procesando.

FAQ (Preguntas Frecuentes)

¿Qué modos de funcionamiento ofrece Mastra Code? Mastra Code incluye tres modos principales: Build (para construcción activa), Plan (para análisis y planeación) y Fast (para velocidad y baja latencia).

¿Cómo puedo ver los cambios realizados en mis archivos? Puedes utilizar el comando /diff dentro de la interfaz para mostrar todos los archivos modificados durante la sesión actual.

¿Puedo usar mis propios servidores MCP? Sí, Mastra Code admite la configuración de servidores MCP y comandos personalizados para adaptarse a las necesidades específicas de tu proyecto.

¿Cómo gestiono los costos de los tokens? El comando /cost te permite visualizar el uso exacto de tokens en la conversación actual, ayudándote a mantener el control sobre tu presupuesto de IA.

¿Es posible cambiar el tema visual? Absolutamente. Con el comando /theme puedes alternar entre los modos auto, oscuro (dark) o claro (light).

Nota: Mastra Code es una herramienta en constante evolución diseñada para integrarse profundamente en el ecosistema de Mastra, permitiendo una personalización sin precedentes mediante su API y opciones de configuración de hilos por proyecto.