O Modo Shell executa comandos de shell diretamente pelo CLI sem sair da sua conversa. Usa para comandos rápidos e não interativos, com verificações de segurança e a saída exibida na conversa.

​
Execução de comandos

Os comandos são executados no teu shell de login ($SHELL), usando o diretório de trabalho e o ambiente do CLI. Encadeia comandos para executar em outros diretórios: 
cd subdir && npm test

​
Saída

Saídas muito extensas são truncadas automaticamente, e processos de longa execução têm timeout para manter o desempenho.

​
Limitações

  • Comandos expiram após 30 segundos
  • Processos de longa execução, servidores e prompts interativos não são compatíveis
  • Usa comandos curtos e não interativos para obter os melhores resultados

​
Permissões

Os comandos são verificados em relação às tuas permissões e às configurações da equipe antes da execução. Consulta Permissões para ver a configuração detalhada. Políticas de administração podem bloquear certos comandos, e comandos com redirecionamento não podem ser adicionados à allowlist inline.

​
Diretrizes de uso

O Shell Mode funciona bem para verificações de status, compilações rápidas, operações com arquivos e inspeção do ambiente. Evita executar servidores de longa duração, aplicativos interativos e comandos que exigem entrada. Cada comando é executado de forma independente — usa cd <dir> && ... para executar comandos em outros diretórios.

​
Solução de problemas

  • Se um comando travar, cancela com Ctrl+C e adiciona flags não interativas
  • Quando pedirem permissões, aprova uma vez ou adiciona à allowlist com Tab
  • Se a saída estiver truncada, usa Ctrl+O para expandir
  • Pra rodar em diretórios diferentes, usa cd <dir> && ... já que as mudanças não persistem
  • O Shell Mode dá suporte a zsh e bash com base na tua variável $SHELL

​
FAQ