Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Executar comandos de shell

Aula 11 de 16 Atualizada a 29 de julho de 2026 Programador
Nesta página
  1. Um shell completo dentro da sessão
  2. O prefixo ! para execução direta
  3. Aprovação e como relaxá-la
  4. Encadeamento, referência e rascunho
  5. O que estes comandos permitem no trabalho diário
  6. Pontos-chave

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