En el desarrollo de software diario, la alternancia constante entre la interfaz web de un asistente de inteligencia artificial y la terminal local representa una pérdida crítica de concentración: los desarrolladores deben copiar trazas de error, transferir fragmentos de código manualmente y aplicar parches dispersos en sus repositorios locales. Mistral Vibe (mistral-vibe), el agente de codificación de código abierto desarrollado por Mistral AI para ejecutarse de forma nativa en la línea de comandos, elimina por completo esta fricción.
Al operar directamente en el directorio raíz de un proyecto, Mistral Vibe interpreta el árbol de directorios, comprende el estado de las ramas y confirmaciones de Git, genera código repetitivo estructurado en múltiples archivos y ejecuta suites de pruebas en sesiones de shell gestionadas, todo guiado mediante lenguaje natural sin abandonar la terminal.
1. Requisitos previos e instalación
Mistral Vibe está optimizado para entornos de terminal modernos. Su soporte oficial se centra en Linux y macOS, aunque también es totalmente funcional en Windows mediante uv o entornos PowerShell.
Requisitos del sistema
- Python 3.10 o superior (si se instala a través del gestor de paquetes de Python).
- Un emulador de terminal moderno con soporte para UTF-8 y colores ANSI (como Ghostty, WezTerm, Kitty o Alacritty).
- Una clave de API de Mistral AI (generada desde Mistral AI Console) o una suscripción activa a Mistral.
Opciones de instalación
Puedes instalar Mistral Vibe mediante cualquiera de los siguientes métodos:
Método 1: Script de instalación en una línea (recomendado para macOS y Linux)
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Método 2: Mediante uv (la opción más rápida y con entorno aislado)
uv tool install mistral-vibe
Método 3: Instalación estándar con pip
pip install mistral-vibe
Configuración inicial y autenticación
Una vez instalado, inicia el asistente de configuración interactivo:
vibe --setup
El asistente solicitará la variable MISTRAL_API_KEY y la almacenará de forma segura en ~/.vibe/.env. También puedes exportar la clave directamente en el archivo de configuración de tu shell (~/.bashrc o ~/.zshrc):
export MISTRAL_API_KEY="tu-clave-api-de-mistral"
Al iniciar Vibe por primera vez dentro de un repositorio con configuraciones locales, el sistema de carpetas de confianza (Trust Folder System) te pedirá que confirmes si confías en el espacio de trabajo actual. Al confirmar, el directorio se registra en ~/.vibe/trusted_folders.toml, evitando la ejecución accidental de comandos en ubicaciones no verificadas.
2. Conceptos clave: perfiles de agente y control de seguridad
El uso de agentes autónomos exige límites claros de permisos. Mistral Vibe incluye perfiles preconfigurados que regulan si el agente puede leer archivos, aplicar ediciones o ejecutar comandos en la terminal sin requerir confirmación humana.
| Perfil de agente | Aprobaciones de herramientas y límites de seguridad | Caso de uso típico |
|---|---|---|
accept-edits (Predeterminado) | Aprueba automáticamente cambios en archivos (write_file, edit); solicita confirmación antes de ejecutar comandos de terminal. | Desarrollo habitual de funciones, andamiaje de código y refactorizaciones. |
plan | Modo de solo lectura. Autoaprueba herramientas de inspección seguras (read, grep, ripgrep); bloquea modificaciones y comandos. | Auditoría de arquitectura, evaluación técnica y exploración segura. |
ask | Exige confirmación manual antes de ejecutar cualquier herramienta o modificar archivos. | Mantenimiento de código crítico de producción o proyectos externos desconocidos. |
auto-approve (--yolo) | Aprueba automáticamente todas las herramientas, escrituras de archivos y comandos de shell sin interrupción. | Flujos de integración continua (CI/CD), scripts desatendidos y entornos efímeros. |
Puedes definir el perfil al iniciar la sesión:
vibe --agent plan
Durante una sesión interactiva activa, puedes alternar entre perfiles en cualquier momento presionando Shift+Tab.
3. Navegación en la interfaz interactiva de la terminal
Para comenzar, dirígete a la raíz de tu proyecto e inicia el comando:
cd /ruta/a/tu-proyecto
vibe
Mistral Vibe desplegará una interfaz de usuario de terminal (TUI) completa, incorporando de manera automática la ruta del proyecto, la rama activa de Git y los commits recientes al contexto del modelo.
Primitivas de sintaxis interactiva
En el campo de entrada puedes utilizar prefijos especiales para enriquecer tus solicitudes:
@ruta/al/archivo: Hace referencia a un archivo o carpeta específica con autocompletado de Git. También permite enlazar imágenes (.png,.jpg,.webp), que se transmiten de forma nativa a modelos multimodales con capacidades visuales.!comando: Escape a shell. Ejecuta comandos directamente en el sistema local sin enviarlos al modelo (por ejemplo,!git diffo!pytest)./: Abre el selector de comandos de barra inclinada para la administración de la sesión.
Comandos de barra inclinada esenciales
/model: Permite cambiar el modelo en uso (comomistral-medium-3.5ocodestral-latest)./config: Abre el editor interactivo de configuración y temas./mcpo/connectors: Muestra los servidores y conectores activos de Model Context Protocol (MCP)./loop [programación]: Agenda tareas periódicas (por ejemplo,/loop every five minutes check git status and test)./retry [instrucción]: Reanuda la generación tras una interrupción y ajusta la dirección de la respuesta./clear: Restablece el historial de contexto de la sesión actual./exit(o:q): Cierra la sesión de forma segura.
Atajos de teclado en la TUI
Shift+Tab: Alterna entre los perfiles de agente (accept-edits,plan,ask).Ctrl+O: Oculta o expande la vista detallada de salida de las herramientas.Ctrl+T: Muestra u oculta la lista de tareas pendientes (todo) del agente.Ctrl+G: Abre el editor externo configurado en el sistema ($EDITOR) para redactar solicitudes complejas.Escape: Interrumpe de inmediato el turno de generación activo.
4. Ejecución de flujos de trabajo de programación agéntica
Mistral Vibe demuestra su verdadero potencial en tres flujos de trabajo clave: análisis de bases de código, generación de andamiaje multifichero y refactorización guiada por pruebas.
Flujo 1: Exploración segura de arquitectura con subagentes
Al enfrentarte a un repositorio desconocido, el modo de planificación permite analizar el diseño sin riesgo de modificaciones accidentales:
vibe --agent plan
Ejemplo de solicitud:
Rastrea cómo el middleware de autenticación valida los tokens JWT e identifica en qué punto se inyectan los reclamos (claims) del usuario en el contexto de la solicitud.
El agente emplea grep y read para examinar el código. Cuando la tarea requiere una búsqueda extensa, Vibe recurre a la herramienta task() para delegar la exploración a su subagente interno explore. Este subagente trabaja de forma paralela en un contexto independiente, preservando el límite de tokens de la conversación principal.
Flujo 2: Andamiaje y generación de código modular multifichero
Mistral Vibe puede crear y coordinar múltiples componentes de software en una sola interacción:
Crea un subsistema de monitorización y salud en src/monitoring/:
1. Genera src/monitoring/health.py con comprobaciones de recursos (CPU, memoria y disco).
2. Genera src/monitoring/metrics.py con métricas exportables en formato Prometheus.
3. Conecta el nuevo enrutador de salud en src/main.py.
4. Escribe pruebas unitarias completas en tests/test_monitoring.py.
Bajo el perfil predeterminado accept-edits:
- Vibe lee la estructura de rutas en
src/main.pymedianteread. - Escribe los nuevos módulos de código y pruebas con
write_file. - Aplica un parche preciso en
src/main.pymedianteeditsin modificar el código no relacionado. - Solicita confirmación antes de ejecutar las pruebas en la terminal.
Flujo 3: Refactorización multifichero y ciclo autónomo de pruebas
Las refactorizaciones complejas requieren modificar múltiples dependencias y verificar que las suites de pruebas sigan pasando.
Ejemplo de solicitud:
Refactoriza la gestión de sesiones de base de datos en @src/services/user_service.py y @src/services/order_service.py de sesiones síncronas a sesiones asíncronas con SQLAlchemy. Ajusta los controladores en @src/api/routes.py y ejecuta la suite de pruebas hasta que todas pasen con éxito.
El agente lleva a cabo el ciclo completo:
- Inspección: Analiza los modelos, servicios y controladores.
- Aplicación de parches: Modifica los archivos involucrados mediante diffs unificados.
- Ejecución de pruebas: Solicita autorización para ejecutar
pytest tests/. - Autocorrección iterativa: Si una prueba falla por falta de
awaito errores en transacciones, Vibe captura la salida estándar y de error, localiza la consulta defectuosa, aplica una nueva corrección y vuelve a ejecutar las pruebas hasta obtener un resultado limpio.
5. Personalización del proyecto: AGENTS.md, habilidades y MCP
Para que Mistral Vibe respete los estándares arquitectónicos de tu equipo, puedes definir reglas de personalización tanto globales como locales.
Estandarización con AGENTS.md
Mistral Vibe incorpora automáticamente el contenido de los archivos AGENTS.md en las instrucciones del sistema:
~/.vibe/AGENTS.md: Directrices globales para todos los repositorios en tu equipo../AGENTS.md: Normas específicas para el proyecto actual (tienen prioridad sobre las globales).
Un ejemplo práctico de AGENTS.md:
# Pautas de ingeniería del proyecto
- Todo el código en Python debe incluir anotaciones de tipo compatibles con Python 3.12.
- Las pruebas asíncronas deben emplear pytest con asyncio_mode = "auto".
- No modifiques archivos de migración en alembic/versions/ sin orden explícita.
- Ejecuta ruff format antes de dar por concluida cualquier tarea.
Extensión con habilidades personalizadas (Skills)
Vibe adopta el estándar abierto Agent Skills. Puedes añadir nuevos comandos creando un archivo SKILL.md dentro de .vibe/skills/<nombre-habilidad>/ o .agents/skills/<nombre-habilidad>/:
---
name: security-audit
description: Escanear el repositorio en busca de credenciales expuestas y dependencias vulnerables
user-invocable: true
allowed-tools:
- read
- grep
- bash
---
# Habilidad de auditoría de seguridad
Ejecuta comprobaciones de dependencias con pip-audit y busca tokens confidenciales en el código.
Una vez creado, escribir /security-audit en la terminal ejecuta el procedimiento configurado.
6. Modo programático y automatización en CI/CD
Además del uso interactivo, Mistral Vibe permite ejecutar tareas de forma desatendida mediante su modo programático, ideal para pipelines de CI/CD o revisiones automatizadas.
Para ejecutar una tarea sin interacción, utiliza el modificador -p o --prompt:
vibe --prompt "Revisa los archivos modificados en git diff HEAD~1, corrige problemas de formato y actualiza README.md si cambiaron firmas de la API" \
--auto-approve \
--max-turns 10 \
--max-price 1.50 \
--output json \
--output-dir ./ci-artifacts/
Opciones de control y presupuesto en modo desatendido
--max-turns N: Delimita el número máximo de turnos del asistente para evitar bucles imprevistos.--max-price DOLLARS: Establece un tope máximo de gasto en dólares estadounidenses.--max-tokens N: Fija un límite acumulado de tokens (entrada y salida).--time-limit SECONDS: Determina un límite estricto de tiempo de ejecución en segundos.--output FORMAT: Configura la salida en texto (text),jsono flujo delimitado por líneas (streaming).--output-dir DIR: Generaexport.jsoncon metadatos de versión, tokens utilizados y registro del proceso.
7. Buenas prácticas para el desarrollo con agentes en la terminal
- Mantén el árbol de Git limpio antes de iniciar cambios grandes: Antes de solicitar modificaciones extensas, confirma tus cambios o utiliza
git stash. Un historial limpio te permite revisar diferencias congit diffo revertir cualquier acción con facilidad. - Utiliza
@para delimitar el contexto crítico: En repositorios grandes, etiquetar archivos clave (como@src/core/config.py) previene búsquedas innecesarias y optimiza el consumo de tokens. - Comienza en modo
planpara tareas complejas: Ante refactorizaciones de gran impacto, pide un plan de acción convibe --agent plan. Tras validarlo, cambia al modoaccept-editspara ejecutar las modificaciones. - Aprovecha el ciclo de pruebas automáticas: En lugar de revisar visualmente cada línea modificada, encomienda al agente la ejecución de los tests de tu proyecto. El agente utilizará los mensajes de error de la terminal para autocorregirse de forma autónoma.