Como Engenheiros de Software Usam a Mistral Vibe CLI para Executar Tarefas de Programação com Agentes Diretamente do Terminal

No fluxo diário de desenvolvimento de software, a alternância frequente entre abas de chat no navegador e o terminal local é uma fonte constante de distração e ineficiência: desenvolvedores precisam copiar mensagens de erro e stack traces, colar trechos de código e integrar manualmente correções fragmentadas aos arquivos locais. A Mistral Vibe (mistral-vibe), agente de código aberto criado pela Mistral AI para operar nativamente na linha de comando, elimina essa barreira.

Ao ser executada diretamente na raiz de um projeto, a Mistral Vibe compreende a estrutura de pastas, reconhece a branch e os commits recentes do Git, gera scaffolding e código boilerplate em múltiplos arquivos e roda suites de testes em sessões gerenciadas de shell, tudo acionado por comandos em linguagem natural a partir do terminal.

1. Pré-requisitos e Instalação

A Mistral Vibe foi projetada para emuladores de terminal modernos. Embora o foco principal sejam ambientes UNIX (Linux e macOS), ela também funciona no Windows por meio do gerenciador uv ou do PowerShell.

Requisitos do Sistema

• Python 3.10 ou superior (quando instalada via gerenciador de pacotes Python).
• Emulador de terminal moderno com suporte a UTF-8 e sequências de escape ANSI (como Ghostty, WezTerm, Kitty ou Alacritty).
• Uma chave de API da Mistral AI (obtida no Mistral AI Console) ou assinatura ativa da Mistral.

Métodos de Instalação

Escolha uma das opções a seguir de acordo com seu ambiente de trabalho:

Método 1: Script em Linha Única (Recomendado para macOS e Linux)

curl -LsSf https://mistral.ai/vibe/install.sh | bash

Método 2: Instalação via uv (Mais Rápida e com Ambiente Isolado)

uv tool install mistral-vibe

Método 3: Instalação Padrão via pip

pip install mistral-vibe

Configuração Inicial e Credenciais

Após a instalação, execute o assistente interativo de configuração:

vibe --setup

O assistente solicitará a sua MISTRAL_API_KEY e a salvará de forma protegida em ~/.vibe/.env. Se preferir, declare a variável de ambiente diretamente na configuração do seu shell (~/.bashrc ou ~/.zshrc):

export MISTRAL_API_KEY="sua-chave-api-da-mistral"

Ao iniciar a Vibe pela primeira vez em um repositório com configurações locais, o sistema de pastas confiáveis (Trust Folder System) solicita a confirmação de segurança do diretório. A pasta aprovada é registrada em ~/.vibe/trusted_folders.toml, impedindo a execução indevida de ferramentas em repositórios desconhecidos.

2. Conceitos Centrais: Perfis de Agente e Segurança

A utilização de agentes autônomos exige delimitações claras de permissão. A Mistral Vibe disponibiliza perfis integrados que determinam o nível de autonomia do agente para ler arquivos, aplicar edições ou executar comandos no sistema.

Você pode definir o perfil desejado no comando de inicialização:

vibe --agent plan

Durante uma sessão interativa, utilize o atalho de teclado Shift+Tab para alternar entre os perfis disponíveis.

3. Navegação na Interface Interativa do Terminal

Para começar a trabalhar, entre no diretório do projeto e execute:

cd /caminho/do/projeto
vibe

A Mistral Vibe carrega uma interface de terminal rica (TUI) e injeta automaticamente as informações da branch do Git, os commits recentes e a árvore de diretórios no contexto do modelo.

Sintaxe de Interação Rápida

No campo de entrada, utilize os seguintes prefixos para direcionar o agente:

• @caminho/do/arquivo: Faz menção direta a arquivos ou pastas com autocompletar do Git. Imagens (.png, .jpg, .webp) também podem ser anexadas e são enviadas nativamente a modelos multimodais de visão.
• !comando: Escape para shell local. Executa comandos diretamente no sistema sem passar pelo modelo de linguagem (por exemplo, !git diff ou !pytest).
• /: Abre o menu de comandos de barra para gerenciar a sessão.

Principais Comandos de Barra

• /model: Alterna o modelo em uso (como mistral-medium-3.5 ou codestral-latest).
• /config: Abre o editor interativo de preferências e temas.
• /mcp ou /connectors: Lista os servidores e conectores ativos do Model Context Protocol (MCP).
• /loop [frequência]: Configura tarefas recorrentes (por exemplo, /loop every five minutes check git status and test).
• /retry [orientação]: Retoma a geração caso ela seja interrompida e ajusta a resposta em andamento.
• /clear: Limpa o histórico de contexto da conversa atual.
• /exit (ou :q): Encerra a sessão com segurança.

Atalhos Úteis na TUI

• Shift+Tab: Alterna entre os perfis (accept-edits, plan, ask).
• Ctrl+O: Alterna a visualização dos logs detalhados de execução das ferramentas.
• Ctrl+T: Abre ou esconde a lista interna de tarefas pendentes (todo) do agente.
• Ctrl+G: Abre o editor de texto padrão do sistema ($EDITOR) para redigir prompts longos.
• Escape: Interrompe a geração atual do modelo imediatamente.

4. Fluxos de Trabalho Práticos com a Mistral Vibe

A Mistral Vibe atende a três fluxos essenciais de engenharia de software: análise arquitetural, scaffolding de novos módulos e refatoração com ciclo autônomo de testes.

Fluxo 1: Exploração Segura com Delegação para Subagentes

Ao estudar um repositório pela primeira vez, o modo de planejamento oferece total segurança:

vibe --agent plan

Exemplo de prompt:

Analise como o middleware de autenticação valida os tokens JWT e explique em que ponto os dados do usuário (claims) são inseridos no contexto das requisições.

O agente utiliza grep e read para mapear a lógica. Em pesquisas mais profundas, a Vibe utiliza a ferramenta task() para delegar a indexação ao subagente interno explore. Subagentes atuam em contextos isolados, preservando a janela de tokens da conversa principal.

Fluxo 2: Scaffolding e Geração de Código em Múltiplos Arquivos

A Mistral Vibe é capaz de criar e estruturar módulos completos com apenas uma instrução:

Crie um subsistema de monitoramento em src/monitoring/:
1. Crie src/monitoring/health.py com checagens de CPU, memória e disco.
2. Crie src/monitoring/metrics.py expondo métricas no formato do Prometheus.
3. Conecte o novo roteador de saúde em src/main.py.
4. Crie testes unitários em tests/test_monitoring.py.

No modo padrão accept-edits:

1. A Vibe lê a estrutura de rotas em src/main.py com read.
2. Cria os novos arquivos com write_file.
3. Aplica correções cirúrgicas em src/main.py com a ferramenta edit, sem alterar código não relacionado.
4. Solicita sua confirmação antes de rodar os testes no terminal.

Fluxo 3: Refatoração Complexa e Loop Autônomo de Testes

Tarefas de refatoração exigem atualizações coordenadas entre camadas de código e validação constante dos testes.

Exemplo de prompt:

Refatore o gerenciamento de sessões do banco de dados em @src/services/user_service.py e @src/services/order_service.py de sessões síncronas para sessões assíncronas com SQLAlchemy. Atualize os handlers em @src/api/routes.py e rode a suite de testes até que tudo passe com sucesso.

O agente cumpre o ciclo de ponta a ponta:

1. Inspeção: Analisa serviços, rotas e testes existentes.
2. Edição: Aplica as alterações nos arquivos afetados via diffs estruturados.
3. Execução de Testes: Solicita autorização para rodar pytest tests/.
4. Autocorreção: Caso um teste falhe por ausência de await ou erros de transação, a Vibe lê os erros no terminal, identifica o ponto exato da falha, reaplica a correção e executa o teste novamente até a validação completa.

5. Customização de Projetos: AGENTS.md, Skills e MCP

Para garantir que a Vibe respeite os padrões técnicos da sua equipe, é possível personalizar suas diretrizes em múltiplos níveis.

Padronização de Regras com AGENTS.md

A Mistral Vibe carrega automaticamente as instruções contidas em arquivos AGENTS.md:

• ~/.vibe/AGENTS.md: Diretrizes globais para todos os projetos da máquina.
• ./AGENTS.md: Regras exclusivas do projeto atual (com prioridade sobre as globais).

Exemplo prático de AGENTS.md:

# Diretrizes Técnicas do Repositório

- Todo o código em Python deve conter anotações de tipo compatíveis com Python 3.12.
- Testes assíncronos devem utilizar pytest com asyncio_mode = "auto".
- Não altere arquivos em alembic/versions/ sem orientação expressa.
- Execute ruff format antes de concluir qualquer tarefa.

Extensão com Habilidades Customizadas (Skills)

Seguindo o padrão aberto Agent Skills, você pode criar comandos de barra personalizados definindo um arquivo SKILL.md em .vibe/skills/<nome-da-skill>/ ou .agents/skills/<nome-da-skill>/:

---
name: security-audit
description: Verificar vulnerabilidades em dependências e segredos expostos
user-invocable: true
allowed-tools:
  - read
  - grep
  - bash
---

# Habilidade de Auditoria de Segurança
Executa verificações com pip-audit e busca tokens confidenciais no código-fonte.

Após salvar o arquivo, basta digitar /security-audit na linha de comando da Vibe para executar o procedimento.

6. Modo Programático e Automação em CI/CD

Além da experiência interativa, a Mistral Vibe possui um modo programático desatendido que facilita sua inclusão em esteiras de CI/CD e rotinas automáticas de manutenção.

Inicie tarefas não interativas com o parâmetro -p ou --prompt:

vibe --prompt "Analise os arquivos alterados em git diff HEAD~1, corrija problemas de formatação e atualize o README.md se as assinaturas da API mudaram" \
     --auto-approve \
     --max-turns 10 \
     --max-price 1.50 \
     --output json \
     --output-dir ./ci-artifacts/

Controles de Custo e Execução no Modo Desatendido

• --max-turns N: Delimita a quantidade máxima de rodadas de resposta do agente.
• --max-price DOLLARS: Define um limite máximo de gastos em dólares.
• --max-tokens N: Determina o limite total de tokens permitidos na execução.
• --time-limit SECONDS: Estipula um tempo limite rígido em segundos.
• --output FORMAT: Configura a saída como texto simples (text), json ou fluxo contínuo (streaming).
• --output-dir DIR: Grava o arquivo export.json contendo versão, configurações ativas, consumo de tokens e histórico da sessão.

7. Melhores Práticas para o Uso de Agentes no Terminal

1. Mantenha o Git Limpo Antes de Modificações Grandes: Faça commit das alterações pendentes ou utilize git stash antes de solicitar grandes mudanças. Isso garante que você possa auditar os diffs com facilidade ou reverter arquivos caso necessário.
2. Utilize o @ para Focar nos Arquivos Essenciais: Em projetos extensos, referenciar arquivos como @src/core/config.py economiza tokens e impede que o agente gaste tempo varrendo diretórios desnecessários.
3. Use o Modo plan para Decisões Arquiteturais: Em tarefas complexas, solicite um plano detalhado com vibe --agent plan. Quando o plano estiver aprovado, mude para accept-edits para implementar o código.
4. Confie na Validação por Testes: Permita que o agente execute os testes do projeto no terminal. As mensagens de erro e o feedback direto do compilador e do test runner são a melhor forma de garantir a qualidade do código produzido.

Referências

• GitHub - mistralai/mistral-vibe: Minimal CLI coding agent by Mistral
• Mistral AI Documentation
• Mistral AI Console
• Agent Skills: An open format for skills