Command no terminal

Use o Command no terminal (Cmd/Ctrl+I) para gerar a sintaxe correta de CLI a partir de instruções em linguagem natural.

Enviar seleção do terminal para o Cascade

Destaque um trecho do stack trace e pressione Cmd/Ctrl+L para enviá-lo ao Cascade, onde você poderá mencionar essa seleção no próximo prompt.

Mencione seu terminal com @

Converse com o Cascade sobre seus terminais ativos.

Comandos do Cascade executados automaticamente

O Cascade pode executar comandos de terminal por conta própria com a permissão do usuário. Você pode configurar como o Cascade lida com a execução de comandos por meio de quatro níveis distintos de autoexecução, e determinados comandos de terminal podem ser aceitos ou rejeitados automaticamente por meio das listas Allow e Deny.

Níveis de execução automática

Windsurf oferece quatro níveis de execução automática de comandos, dando a você controle sobre como o Cascade executa comandos de terminal:

Nível	Descrição
Disabled	A execução automática fica completamente desativada. Todos os comandos exigem aprovação manual antes da execução.
Allowlist Only	Somente comandos que correspondem a entradas na sua lista de permissões podem ser executados automaticamente. Todos os outros comandos exigem aprovação manual.
Auto	O Cascade usa seu próprio julgamento para determinar se um comando é seguro para execução automática. Comandos considerados potencialmente arriscados ainda exigirão sua aprovação. Este recurso só está disponível para mensagens enviadas com modelos de IA premium.
Turbo	Todos os comandos são executados automaticamente imediatamente, exceto aqueles na sua lista de bloqueio.

Você pode selecionar seu nível de execução automática preferido pelo painel de Configurações do Windsurf no canto inferior direito do editor.

Nível Máximo Controlado pelo Administrador (Teams & Enterprise)

Para usuários dos planos Teams e Enterprise, administradores podem definir um nível máximo permitido de autoexecução para sua organização. Essa configuração restringe quais níveis ficam disponíveis para os membros da equipe, permitindo que os administradores imponham políticas de segurança e, ao mesmo tempo, deem flexibilidade aos usuários dentro desses limites. Quando um administrador define um nível máximo, os usuários podem selecionar qualquer nível até esse máximo (inclusive). Por exemplo, se um administrador definir o máximo como “Auto”, os usuários poderão escolher entre Disabled, Allowlist Only ou Auto, mas não poderão habilitar o modo Turbo. Os administradores podem configurar essa opção no Admin Portal, em Team Settings.

Listas de comandos em nível de equipe (Teams & Enterprise)

Administradores podem configurar listas de permissão (allowlist) e de bloqueio (denylist) em nível de equipe para comandos de terminal que se aplicam a todos os membros da equipe. Essas listas funcionam em conjunto com as listas de permissão/bloqueio de usuários individuais.

Tipo de lista	Comportamento
Allowlist	Comandos que coincidirem com entradas nesta lista serão executados automaticamente, sem confirmação do usuário (quando a autoexecução estiver ativada para o usuário).
Denylist	Comandos que coincidirem com entradas nesta lista sempre exigirão aprovação do usuário antes da execução, independentemente das configurações do usuário.

Comportamentos principais:

As configurações de equipe e de usuário são combinadas: As listas em nível de equipe são mescladas com as listas de permissão/bloqueio de usuários individuais configuradas nas configurações do Windsurf. Um comando que coincidir com a allowlist da equipe ou do usuário será executado automaticamente (a menos que seja bloqueado por uma denylist).
A denylist tem precedência sobre a allowlist — se um comando coincidir com ambas as listas (no nível da equipe ou do usuário), ele exigirá aprovação.

Para configurar listas de comandos em nível de equipe, acesse o Admin Portal → Team Settings → Terminal Commands → Manage Lists.

Lista de permissões

Uma lista de permissões define um conjunto de comandos de terminal que sempre serão executados automaticamente. Por exemplo, se você adicionar git, o Cascade sempre aceitará git add -A. A configuração pode ser feita pela Paleta de Comando → Open Settings (UI) → Search for windsurf.cascadeCommandsAllowList.

Lista de bloqueio

Uma lista de bloqueio define um conjunto de comandos de terminal que nunca serão executados automaticamente. Por exemplo, se você adicionar rm, o Cascade sempre pedirá permissão para executar rm index.py. A configuração pode ser feita pela Paleta de Comando → Open Settings (UI) → Search for windsurf.cascadeCommandsDenyList.

Terminal dedicado

A partir da Wave 13, o Windsurf passou a ter um terminal dedicado para o Cascade executar comandos no macOS. Esse terminal dedicado é separado do seu terminal padrão e sempre usa zsh como shell.

O terminal dedicado vai usar sua configuração do zsh, então aliases e variáveis de ambiente ficarão disponíveis a partir do .zshrc e de outros arquivos específicos do zsh. Se você usar um shell diferente em vez do zsh e quiser que o Windsurf use variáveis de ambiente compartilhadas, recomendamos criar um arquivo de configuração compartilhado que ambos os shells possam importar.

Solução de problemas

Se você encontrar problemas com o terminal dedicado, poderá voltar para o terminal legado ativando a opção Legacy Terminal Profile nas configurações do Windsurf.

Editor

Cascade

Contas

Consciência de contexto

Resolução de problemas