Pular para o conteúdo principal
O Shell Mode executa comandos de shell direto pela CLI sem sair da tua conversa. Usa pra comandos rápidos, não interativos, com verificações de segurança e a saída aparecendo na conversa.

​
Execução de comandos

Os comandos rodam no teu shell de login ($SHELL) com o diretório de trabalho e o ambiente da 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 timeout para manter o desempenho.

​
Limitações

  • Comandos atingem timeout 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 melhores resultados

​
Permissões

Os comandos são verificados em relação às suas permissões e às configurações da sua equipe antes da execução. Veja Permissões para configuração detalhada. Políticas de administrador podem bloquear determinados 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, builds rápidas, operações com arquivos e inspeção de ambiente. Evita 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 solicitar permissões, aprova uma vez ou adiciona à allowlist com Tab
  • Se a saída estiver truncada, usa Ctrl+O pra expandir
  • Pra rodar em diretórios diferentes, usa cd <dir> && ... já que as mudanças não persistem
  • O Modo Shell suporta zsh e bash com base na tua variável $SHELL

​
FAQ

Não. Cada comando roda de forma independente. Usa cd <dir> && ... para executar comandos em diretórios diferentes.
Não. Os comandos têm limite de 30 segundos e isso não é configurável.
As permissões são gerenciadas pela CLI e pela configuração do time. Usa o banner de decisão para adicionar comandos às allowlists.
Pressiona Esc quando a entrada estiver vazia, BackSpace/Delete com a entrada vazia ou Ctrl+C para limpar e sair.
⌘I