O Modo Shell executa comandos de shell diretamente pelo CLI sem sair da 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 rodam no teu shell de login ($SHELL) com o diretório de trabalho e o ambiente do CLI. Encadeia comandos para rodar em outros diretórios: 
cd subdir && npm test

​
Saída

Saídas extensas são truncadas automaticamente e processos de longa execução têm tempo limite 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 suportados
  • Usa comandos curtos e não interativos para ter os melhores resultados

​
Permissões

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

​
Diretrizes de uso

O Modo Shell funciona bem para checagens de status, builds rápidas, operações de arquivos e inspeção do ambiente. Evita servidores de longa duração, aplicativos interativos e comandos que exigem entrada. Cada comando é executado de forma independente — usa cd <dir> && ... para rodar 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 a partir da tua variável $SHELL

​
Perguntas frequentes