Executar comandos de shell
Nesta página
Um shell completo dentro da sessão
O Vibe inclui um terminal Bash com estado. A palavra-chave é com estado: o ambiente persiste de um comando para o seguinte. Isso significa que as variáveis de ambiente que exportar, o diretório de trabalho atual para onde navegar e os aliases que definir permanecem ativos para os comandos subsequentes. Não começa do zero a cada chamada, ao contrário de ferramentas que iniciam um subshell descartável.
O agente utiliza este terminal sempre que necessário — para executar testes, verificar o estado ou instalar uma dependência —, mas também pode invocar comandos diretamente.
O prefixo ! para execução direta
Quando sabe exatamente o que deseja executar, o caminho mais rápido é o prefixo !:
!ls -la src/
!git log --oneline -10
!npm run test -- --watch
Este ! indica ao Vibe que tudo o que se segue é um comando de shell a executar tal como está, sem interpretação do agente. O resultado aparece imediatamente e mantém-se no modo interativo.
A alternativa é deixar o agente traduzir a sua intenção. Peça-lhe para executar testes unitários, instalar a dependência axios ou verificar se o servidor de desenvolvimento inicia corretamente. Ele determina o comando adequado para o seu projeto — npm, pip, cargo — e propõe-no para sua aprovação. Esta é a abordagem preferida ao explorar um projeto cujas convenções de ferramentas ainda não conhece.
Aprovação e como relaxá-la
Por predefinição, cada comando de shell requer a sua confirmação. O Vibe mostra exatamente o que planeia executar e aguarda:
O agente pretende executar:
npm run test
Aprovar? (y/n)
Este mecanismo é a principal rede de segurança da ferramenta. Uma proposta acidental de rm -rf não tem efeito até que a aprove — essa é a diferença entre um incidente e uma linha de texto que rejeita com um n.
Pode configurar este comportamento no ficheiro config.toml com permissões granulares por ferramenta:
[tools.bash]
permission = "ask" # Perguntar sempre (predefinição)
# Ou para um agente de confiança:
# permission = "always" # Executar sem perguntar
Também pode relaxar isto no momento: Shift+Tab alterna o modo de aprovação automática, onde o Vibe executa comandos sem confirmação. Isto é conveniente durante sessões de desenvolvimento intensivas em que segue o agente passo a passo, mas manuseie com cuidado, pois está a contornar a rede de segurança descrita acima. O sistema Trust Folder ajuda a limitar o risco: apenas os diretórios explicitamente marcados como seguros em ~/.vibe/trusted_folders.toml permitem a aprovação automática. Um repositório clonado para resolução de problemas e nunca declarado não beneficiará disto.
Encadeamento, referência e rascunho
O prefixo @ também funciona para comandos: referenciar um ficheiro injeta o seu conteúdo no contexto, permitindo ao agente compreender antes de agir.
Execute o script @scripts/deploy.sh e explique o que ele faz
O agente lê primeiro o script, analisa-o e, em seguida, executa-o se aprovar — uma ordem particularmente tranquilizadora para um script de implantação que não escreveu.
Para uma sequência de operações, compose uma mensagem de várias linhas usando Ctrl+J ou Shift+Enter:
Execute estes comandos por ordem:
1. git stash
2. git pull origin main
3. git stash pop
4. npm install
5. npm run build
O Vibe executa os passos sequencialmente, para se um falhar e mostra-lhe o resultado de cada um. Isto impede que descubra uma falha no stash pop apenas após uma compilação inútil. E se a mensagem que precisa de redigir se tornar longa ou estruturada, Ctrl+G abre o seu editor externo definido por $EDITOR: escreve confortavelmente, guarda, fecha e o conteúdo vai para o Vibe.
O que estes comandos permitem no trabalho diário
A gestão de dependências presta-se bem ao encadeamento automático: “Atualizar todas as dependências npm e verificar vulnerabilidades” aciona npm update e depois npm audit, fornecendo-lhe um resumo em vez de uma parede de output. O impacto é mais claro, contudo, com os testes. Um pedido como “Execute os testes e, se algum falhar, analise os erros e proponha correções” combina execução, diagnóstico e uma proposta de correção numa única troca.
O mesmo princípio aplica-se ao resto da cadeia: peça-lhe para compilar o projeto em modo de produção e verificar se não há erros TypeScript, ou listar os contentores Docker em execução e mostrar os logs do contentor api. Em todos estes casos, descreve o objetivo, o agente escolhe os comandos e você mantém o controlo na fase de aprovação.
Pontos-chave
- O prefixo
!executa um comando de shell diretamente a partir do modo interativo - O agente também pode determinar e executar comandos adequados usando linguagem natural
- Cada comando requer aprovação por predefinição (configurável em config.toml)
- O terminal tem estado: as variáveis e o diretório atual são preservados
- O modo de aprovação automática (Shift+Tab) remove as confirmações — use com cautela
- O sistema Trust Folder protege a aprovação automática por diretório