> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cascade (legado)

> Referência do Cascade, o agente legado do Devin Desktop: modos, memórias e regras, habilidades, AGENTS.md, fluxos de trabalho, worktrees, MCP e hooks.

> [!NOTE]
>
> O Cascade é o agente legado do Devin Desktop. O Devin Desktop não inicia mais novas conversas no Cascade nem abre as antigas. As novas conversas agora começam no [Devin Local](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/overview.md).

## Visão geral

O Cascade do Devin Desktop leva a colaboração entre humanos e IA a um novo nível.

O Cascade era o agente local do Devin Desktop antes do [Devin Local](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/overview.md). O Cascade não está mais disponível no seletor de agente.

> [!NOTE]
>
> O Devin Local e todos os outros agentes ACP ficam indisponíveis enquanto um workspace estiver aberto no Modo Restrito.

##### Links rápidos para recursos

> [card] [Terminal](https://docs.devinenterprise.com/pt-BR/desktop/terminal.md)
>
> Uma experiência de Terminal aprimorada.

> [card] [Fluxos de trabalho](https://docs.devinenterprise.com/pt-BR/desktop/cascade.md#workflows)
>
> Automatize trajetórias repetitivas.

### Seleção de modelo

Selecione o modelo desejado no menu de seleção abaixo da caixa de texto da conversa no Cascade. Clique abaixo para ver a lista completa dos modelos disponíveis e a disponibilidade de cada um nos diferentes planos e preços.

> [card] [Modelos](https://docs.devinenterprise.com/pt-BR/desktop/models.md)
>
> Disponibilidade de modelos no Devin Desktop.

### Cascade Code / Cascade Chat

O Cascade tem dois modos principais: **Code** e **Chat**.

O modo Code permite que o Cascade crie e modifique código na sua base de código, enquanto o modo de chat é otimizado para perguntas sobre a sua base de código ou sobre princípios gerais de programação.

No modo de chat, o Cascade pode sugerir novos trechos de código, que você pode aceitar e inserir.

### Planos e listas de tarefas

O Cascade tem capacidades nativas de planejamento que ajudam a melhorar o desempenho em tarefas mais longas.

Em segundo plano, um agente de planejamento especializado refina continuamente o plano de longo prazo, enquanto o modelo que você selecionou se concentra em executar ações de curto prazo com base nesse plano.

O Cascade cria uma lista de tarefas (Todo list) na própria conversa para acompanhar o progresso de tarefas complexas. Para fazer alterações no plano, basta pedir ao Cascade que atualize a lista de tarefas.

O Cascade também pode atualizar o plano automaticamente à medida que obtém novas informações ao longo da conversa, como uma Memória.

### Mensagens na fila

Enquanto espera o Cascade concluir a tarefa atual, você pode enfileirar novas mensagens, que serão executadas em ordem assim que a tarefa terminar.

Para adicionar uma mensagem à fila, basta digitá-la enquanto o Cascade estiver trabalhando e pressionar `Enter`.

* **Enviar imediatamente**: pressione Enter novamente com a caixa de texto vazia para enviá-la na hora.
* **Excluir**: remova qualquer mensagem da fila antes que ela seja enviada

### Chamada de ferramentas

O Cascade tem à disposição uma variedade de ferramentas, como Search, Analyze, MCP e o [terminal](https://docs.devinenterprise.com/pt-BR/desktop/terminal.md).

Ele consegue detectar quais pacotes e ferramentas você está usando, quais precisam ser instalados e até instalá-los para você. Basta perguntar ao Cascade como executar seu projeto e clicar em Accept.

> [!NOTE]
>
> Por padrão, o Cascade pode fazer até 40 invocações por prompt. Se a trajetória parar nesse limite, basta clicar no botão `continue` para que o Cascade retome de onde parou. No entanto, cada `continue` conta como um novo crédito de prompt, devido aos custos de chamada de ferramentas.

Você pode ativar a configuração `Auto-Continue` para que o Cascade continue a resposta automaticamente ao atingir o limite de invocações, em vez de parar. Isso consome crédito(s) de prompt de acordo com o modelo que você está usando.

No `settings.json`, essa é a configuração `devin.autoContinue`: `0` ou um valor negativo ativa a continuação automática, fazendo com que o Cascade continue indefinidamente; já um valor positivo (o padrão é `40`) a desativa, fazendo com que o Cascade pare no limite de invocações e peça que você continue.

<video autoPlay muted loop playsInline src="https://mintcdn.com/cognitionai-enterprise/UuM77FPA20O2QmDP/desktop/assets/windsurf/cascade/auto-continue.mp4?fit=max&auto=format&n=UuM77FPA20O2QmDP&q=85&s=be09e91d92262d0e8edea4dbf2f7963d" />

### Entrada de voz

Use a Entrada de voz para interagir com o Cascade por voz. Na versão atual, ela transcreve sua fala em texto.

<video autoPlay controls muted loop playsInline src="https://mintcdn.com/cognitionai-enterprise/UuM77FPA20O2QmDP/desktop/assets/windsurf/cascade/voice-mode.mp4?fit=max&auto=format&n=UuM77FPA20O2QmDP&q=85&s=f7ebcae38ed7500a9e14df9fa9c21e5f" />

### Pontos de Controle nomeados e reversões

Você pode reverter as alterações feitas pelo Cascade. Basta passar o mouse sobre o prompt original e clicar na seta de reverter à direita, ou reverter diretamente pelo índice. Isso reverterá todas as alterações no código, restaurando sua base de código ao estado em que estava na etapa desejada.

> [!WARNING]
>
> No momento, não é possível desfazer uma reversão, então tenha cuidado!

<video autoPlay controls muted loop playsInline src="https://mintcdn.com/cognitionai-enterprise/UuM77FPA20O2QmDP/desktop/assets/windsurf/cascade/cascade-revert.mp4?fit=max&auto=format&n=UuM77FPA20O2QmDP&q=85&s=3b12a34de157c33d36dedb621cba727b" />

Você também pode criar, diretamente na conversa, um snapshot/ponto de controle nomeado do estado atual do seu projeto, para o qual é possível navegar facilmente e reverter a qualquer momento.

<video autoPlay controls muted loop playsInline src="https://mintcdn.com/cognitionai-enterprise/UuM77FPA20O2QmDP/desktop/assets/windsurf/cascade/namedcheckpoints.mp4?fit=max&auto=format&n=UuM77FPA20O2QmDP&q=85&s=e37e42f54128fe765873a2627fc9c622" />

### Percepção em tempo real

Um recurso exclusivo do Devin Desktop e do Cascade é a percepção das suas ações em tempo real, o que dispensa a necessidade de incluir no prompt o contexto das suas ações anteriores.

Basta pedir ao Cascade para "Continuar".

<video autoPlay controls muted loop playsInline src="https://mintcdn.com/cognitionai-enterprise/UuM77FPA20O2QmDP/desktop/assets/windsurf-continue.mp4?fit=max&auto=format&n=UuM77FPA20O2QmDP&q=85&s=5729fced8827be4bc0aaa64af38e24e6" />

### Enviar problemas ao agente

Quando o seu código tiver problemas exibidos no painel Problems, na parte inferior do editor, envie-os ao agente como contexto:

* Clique em `Send all to agent` na parte superior do painel Problems para enviar todos os problemas listados no momento.
* Clique em `Send to agent` ao lado de um arquivo no painel Problems para enviar apenas os problemas desse arquivo.

### Explicar e corrigir

Para qualquer erro que você encontrar no editor, basta selecionar o erro e clicar em `Explain and Fix` para que o Cascade o corrija para você.

![](https://mintcdn.com/cognitionai-enterprise/GYcs1r0Vcxr5GSpj/desktop/assets/windsurf/windsurf-explain-fix.png?fit=max\&auto=format\&n=GYcs1r0Vcxr5GSpj\&q=85\&s=65b4b92654dfa479dc4c92a8f843b034)

### Como ignorar arquivos

Se você quiser que o Cascade ignore determinados arquivos, adicione-os ao `.devinignore` (ou ao `.codeiumignore`, legado) na raiz do seu workspace. Isso impede que o Cascade visualize, edite ou crie arquivos nos caminhos especificados. Os caminhos de arquivo podem ser declarados em um formato semelhante ao do `.gitignore`. Consulte [Ignorar arquivos](https://docs.devinenterprise.com/pt-BR/desktop/context-awareness/devin-ignore.md) para mais detalhes.

#### .codeiumignore global

Para clientes empresariais que gerenciam múltiplos repositórios, é possível impor regras de exclusão em todos os repositórios colocando um arquivo `.codeiumignore` global na pasta `~/.codeium/`. Essa configuração global se aplica a todos os workspaces do Devin Desktop no seu sistema e funciona em conjunto com os arquivos `.codeiumignore` específicos de cada repositório.

### Integração com linter

O Cascade pode corrigir automaticamente erros de lint no código gerado. Esse recurso vem ativado por padrão, mas pode ser desativado clicando em `Auto-fix` na chamada de ferramenta e, em seguida, em `disable`. Essa edição não consome créditos.

![](https://mintcdn.com/cognitionai-enterprise/UuM77FPA20O2QmDP/desktop/assets/windsurf/cascade/auto-fix-lint.png?fit=max\&auto=format\&n=UuM77FPA20O2QmDP\&q=85\&s=fc43075ae4c623c887f8d3db0b0de0d7)

Quando o Cascade faz uma edição com o objetivo principal de corrigir erros de lint que ele mesmo gerou e detectou automaticamente,
ele pode isentar essa edição da cobrança de créditos. Isso ocorre porque
corrigir erros de lint aumenta o número de chamadas de ferramenta que o Cascade faz.

### Compartilhamento da sua conversa

Os links de conversas compartilhadas do Cascade não funcionam mais. O Devin Desktop removeu as páginas de conversas compartilhadas do Cascade.

### Use @-Menção para conversas anteriores

Você também pode referenciar conversas anteriores em outras conversas usando uma `@-mention`.

Ao fazer isso, o Cascade recupera as informações mais relevantes e úteis, como os resumos das conversas e os Pontos de Controle, além de partes específicas da conversa que você consultar. Normalmente, ele não recupera a conversa completa, para não sobrecarregar a janela de contexto.

<video autoPlay controls muted loop playsInline src="https://mintcdn.com/cognitionai-enterprise/UuM77FPA20O2QmDP/desktop/assets/windsurf/cascade/at-mention-convos.mp4?fit=max&auto=format&n=UuM77FPA20O2QmDP&q=85&s=8e92f9920775065ad9cceadf6de38464" />

### Cascades simultâneos

Os usuários podem ter múltiplos Cascades em execução simultaneamente. Você pode alternar entre eles usando o menu suspenso no canto superior esquerdo do painel do Cascade.

> [!WARNING]
>
> Se dois Cascades editarem o mesmo arquivo ao mesmo tempo, as edições podem entrar em conflito e, às vezes, a segunda edição falhará.

Se você prevê que dois Cascades vão editar arquivos semelhantes, considere usar [worktrees](https://docs.devinenterprise.com/pt-BR/desktop/cascade.md#worktrees) para mantê-los isolados.

## Fluxos de trabalho

Os fluxos de trabalho permitem que os usuários definam uma série de etapas para orientar o Cascade em um conjunto de tarefas repetitivas, como implantar um serviço ou responder a comentários de PR.

Esses fluxos de trabalho são salvos como arquivos markdown, oferecendo aos usuários e às suas equipes uma forma simples e reproduzível de executar processos essenciais.

Depois de salvos, os fluxos de trabalho podem ser invocados no Cascade por meio de um comando de barra no formato `/[name-of-workflow]`.

> [!NOTE]
>
> Os fluxos de trabalho são **exclusivamente manuais**: o Cascade nunca invocará um fluxo de trabalho automaticamente. Se você quiser que o Cascade aplique um procedimento por conta própria, use uma [skill](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/customizations.md#skills).

Os fluxos de trabalho são exclusivos do Cascade: o [Devin Local](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/overview.md) não oferece suporte a eles. Migre seus fluxos de trabalho para [habilidades](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/customizations.md#skills).

### Como funciona

As Regras geralmente fornecem orientações aos modelos de linguagem de grande porte (LLMs) por meio de um contexto persistente e reutilizável no nível do prompt.

Os fluxos de trabalho ampliam esse conceito ao fornecer uma sequência estruturada de etapas ou prompts no nível da trajetória, conduzindo o modelo por uma série de tarefas ou ações interligadas.

![](https://mintcdn.com/cognitionai-enterprise/UuM77FPA20O2QmDP/desktop/assets/windsurf/cascade/use-workflow-pr.png?fit=max\&auto=format\&n=UuM77FPA20O2QmDP\&q=85\&s=f8b6b4f3ea1315c1a7ccd4cd891dabaa)

Para executar um fluxo de trabalho, basta invocá-lo no Cascade com o comando `/[workflow-name]`.

> [!TIP]
>
> Você pode chamar outros fluxos de trabalho de dentro de um fluxo de trabalho! \
> \
> Por exemplo, /workflow-1 pode incluir instruções como "Call /workflow-2" e "Call /workflow-3".

Após a invocação, o Cascade processa, em sequência, cada etapa definida no fluxo de trabalho, executando ações ou gerando respostas conforme especificado.

### Como criar um fluxo de trabalho

Para começar a usar fluxos de trabalho, clique no ícone `Customizations` no menu lateral deslizante no canto superior direito do Cascade e acesse o painel `Workflows`. Nele, clique no botão `+ Global` ou `+ Workspace` para criar um novo fluxo de trabalho no nível global ou do workspace, respectivamente.

Os fluxos de trabalho são salvos como arquivos markdown nos diretórios `.devin/workflows/` (ou no diretório legado `.windsurf/workflows/`) e contêm um título, uma descrição e uma série de etapas com instruções específicas para o Cascade seguir.

### Descoberta de fluxos de trabalho

O Devin Desktop descobre automaticamente fluxos de trabalho em múltiplos locais, o que permite uma organização flexível:

* **Workspace atual e subdiretórios**: todos os diretórios `.devin/workflows/` (e os legados `.windsurf/workflows/`) do seu workspace atual e de seus subdiretórios
* **Estrutura do repositório Git**: em repositórios Git, o Devin Desktop também pesquisa os diretórios pai, subindo até a raiz do repositório Git, para encontrar fluxos de trabalho
* **Suporte a múltiplos workspaces**: quando múltiplas pastas estão abertas no mesmo workspace, os fluxos de trabalho duplicados são removidos e exibidos com o caminho relativo mais curto

#### Locais de armazenamento de fluxos de trabalho

| Escopo | Local | Notas |
| - | - | - |
| Workspace | `.devin/workflows/*.md` (preferencial) ou `.windsurf/workflows/*.md` (fallback) | No seu workspace atual, em qualquer subdiretório ou em qualquer diretório pai até a raiz do repositório Git. Comitado com o seu repositório. |
| Global | `~/.codeium/windsurf/global_workflows/*.md` | Disponível em todos os workspaces da sua máquina. Não é comitado. |
| Integrado | Gerenciado pelo Devin Desktop | Modelos incluídos no Devin Desktop (p. ex., `/plan`). |
| [System (Enterprise)](#system-level-workflows-enterprise) | Depende do sistema operacional (p. ex., `/etc/devin/workflows/`, legado `/etc/windsurf/workflows/`) | Implantado pela equipe de TI; somente leitura para usuários finais. |

Ao criar um novo fluxo de trabalho pela UI, ele é salvo no diretório `.devin/workflows/` do seu workspace atual, não necessariamente na raiz do repositório Git. Se você recusou a migração em um workspace que ainda tem um diretório `.windsurf/`, ele é salvo em `.windsurf/workflows/`. Para criar um fluxo de trabalho global, use o botão `+ Global` no Painel de fluxos de trabalho ou crie o arquivo diretamente em `~/.codeium/windsurf/global_workflows/`.

Cada arquivo de fluxo de trabalho tem um limite de 12000 caracteres.

<video autoPlay controls muted loop playsInline src="https://mintcdn.com/cognitionai-enterprise/UuM77FPA20O2QmDP/desktop/assets/windsurf/cascade/create-workflow.mp4?fit=max&auto=format&n=UuM77FPA20O2QmDP&q=85&s=e0597b15dc976f94827cfe0182114df8" />

#### Gerar um fluxo de trabalho com o Cascade

Você também pode pedir ao Cascade que gere fluxos de trabalho para você! Isso funciona especialmente bem com fluxos de trabalho que envolvem uma série de etapas em uma ferramenta de CLI específica.

<video autoPlay controls muted loop playsInline src="https://mintcdn.com/cognitionai-enterprise/UuM77FPA20O2QmDP/desktop/assets/windsurf/cascade/create-workflow-with-cascade.mp4?fit=max&auto=format&n=UuM77FPA20O2QmDP&q=85&s=0ff8f39ef0b03e63d4ff3c7c65a7da92" />

### Exemplos de fluxos de trabalho

Há inúmeros casos de uso para fluxos de trabalho, como:

> [card] /address-pr-comments
>
> Este é um fluxo de trabalho que nossa equipe usa internamente para tratar comentários de PR:
>
> ```
> 1. Faça checkout do branch do PR: `gh pr checkout [id]`
>
> 2. Obtenha os comentários do PR
>
>  bash
>  gh api --paginate repos/[owner]/[repo]/pulls/[id]/comments | jq '.[] | {user: .user.login, body, path, line, original_line, created_at, in_reply_to_id, pull_request_review_id, commit_id}'
>
> 3. Para CADA comentário, faça o seguinte. Lembre-se de tratar um comentário por vez.
>  a. Imprima o seguinte: "(index). From [user] on [file]:[lines] — [body]"
>  b. Analise o arquivo e o intervalo de linhas.
>  c. Se você não entender o comentário, não faça nenhuma alteração. Apenas me peça esclarecimentos ou que eu mesmo implemente a alteração.
>  d. Se você achar que consegue fazer a alteração, faça-a ANTES de passar para o próximo comentário.
>
> 4. Depois de processar todos os comentários, resuma o que você fez e quais comentários precisam da atenção do USUÁRIO.
> ```

> [card] /git-workflows
>
> Faça commits em formatos predefinidos e crie pull requests com títulos e descrições padronizados usando os comandos de CLI adequados.

> [card] /dependency-management
>
> Automatize a instalação ou atualização das dependências do projeto com base em um arquivo de configuração (p. ex., requirements.txt, package.json).

> [card] /code-formatting
>
> Execute automaticamente formatadores de código (como Prettier e Black) e linters (como ESLint e Flake8) ao salvar arquivos ou antes de fazer commit, para manter o estilo do código e detectar erros logo no início.

> [card] /run-tests-and-fix
>
> Execute ou adicione testes unitários ou end-to-end e corrija os erros automaticamente para garantir a qualidade do código antes de fazer commit, merge ou deploy.

> [card] /deployment
>
> Automatize as etapas de implantação do seu aplicativo em diferentes ambientes (desenvolvimento, homologação, produção), incluindo as verificações necessárias antes ou depois do deployment.

> [card] /security-scan
>
> Integre e acione varreduras de vulnerabilidades de segurança na sua base de código como parte do pipeline de CI/CD ou sob demanda.

### Fluxos de trabalho no nível do sistema (Enterprise)

Organizações Enterprise podem implantar fluxos de trabalho no nível do sistema que ficam disponíveis globalmente em todos os workspaces e não podem ser modificados por usuários finais sem permissões de administrador. Esse recurso é ideal para garantir a aplicação de processos de desenvolvimento, procedimentos de deployment e fluxos de trabalho de conformidade em toda a organização.

Os fluxos de trabalho no nível do sistema são carregados a partir de diretórios específicos de cada sistema operacional. O Devin Desktop carrega o diretório de fluxos de trabalho `Devin`, se ele existir, e só recorre ao diretório de fluxos de trabalho legado `Windsurf` quando ele não existir. Os dois não são mesclados; portanto, ao criar o diretório `Devin`, mova para ele todos os fluxos de trabalho legados:

**macOS:**

```
/Library/Application Support/Devin/workflows/*.md
/Library/Application Support/Windsurf/workflows/*.md   # fallback legado
```

**Linux/WSL:**

```
/etc/devin/workflows/*.md
/etc/windsurf/workflows/*.md   # fallback legado
```

**Windows:**

```
C:\ProgramData\Devin\workflows\*.md
C:\ProgramData\Windsurf\workflows\*.md   # fallback legado
```

Coloque seus arquivos de fluxo de trabalho (no formato `.md`) no diretório correspondente ao seu sistema operacional. O sistema carregará automaticamente todos os arquivos `.md` desses diretórios.

#### Precedência de fluxos de trabalho

Quando existem fluxos de trabalho com o mesmo nome em múltiplos níveis, os fluxos de trabalho no nível do sistema têm a maior precedência:

1. **System** (maior prioridade) - Fluxos de trabalho para toda a organização implantados pela equipe de TI
2. **Workspace** - Fluxos de trabalho específicos do projeto em `.devin/workflows/` (ou no diretório legado `.windsurf/workflows/`)
3. **Global** - Fluxos de trabalho definidos pelo usuário em `~/.codeium/windsurf/global_workflows/`
4. **Integrado** - Fluxos de trabalho padrão fornecidos pelo Devin Desktop

Isso significa que, se uma organização implantar um fluxo de trabalho no nível do sistema com um determinado nome, ele terá prioridade sobre qualquer fluxo de trabalho do workspace, global ou integrado com o mesmo nome.

Na Interface do Devin Desktop, os fluxos de trabalho no nível do sistema aparecem com o rótulo "System" e não podem ser excluídos pelos usuários finais.

> [!NOTE]
>
> **Importante**: Os fluxos de trabalho no nível do sistema devem ser gerenciados pela sua equipe de TI ou de segurança. Certifique-se de que suas equipes internas cuidem do deployment, das atualizações e da conformidade de acordo com as políticas da sua organização. Para isso, você pode usar ferramentas e fluxos de trabalho padrão, como Mobile Device Management (MDM) ou Gerenciamento de Configuração.

## Worktrees

O Devin Desktop oferece suporte a git worktrees para executar tarefas do Cascade em paralelo, sem interferir no seu workspace principal.

Com worktrees, cada conversa no Cascade tem sua própria sessão, o que permite ao Cascade fazer edições ou fazer build e testar o código sem interferir no seu workspace principal.

O [Devin Local](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/worktrees.md) também pode iniciar uma sessão em uma worktree existente, escolhida no seletor de local do agente, e trazer as alterações de volta com o botão **Merge**.

### Uso básico de worktrees

A maneira mais simples de começar a usar worktrees é alternar para o modo "Worktree" no canto inferior direito do campo de entrada do Cascade.

![](https://mintcdn.com/cognitionai-enterprise/GYcs1r0Vcxr5GSpj/desktop/assets/windsurf/worktree-toggle.png?fit=max\&auto=format\&n=GYcs1r0Vcxr5GSpj\&q=85\&s=5e66820f3af179ffadbf2e9b685e3c12)

> [!NOTE]
>
> No momento, só é possível alternar para um worktree no início de uma sessão do Cascade. Depois de iniciada, uma conversa não pode ser movida para outro worktree.

Depois que o Cascade fizer alterações em arquivos no worktree, você pode clicar em "merge" para incorporar essas alterações de volta ao seu workspace principal.

![](https://mintcdn.com/cognitionai-enterprise/GYcs1r0Vcxr5GSpj/desktop/assets/windsurf/worktree-merge.png?fit=max\&auto=format\&n=GYcs1r0Vcxr5GSpj\&q=85\&s=d7e3fd6b02bb4c1cdc4c596281b21d70)

### Localização

As worktrees são organizadas pelo nome do repositório em `~/.windsurf/worktrees/<repo_name>`.

Cada worktree recebe um nome aleatório exclusivo.

Para ver a lista de worktrees ativas, execute `git worktree list` dentro do diretório do repositório.

> [!WARNING]
>
> Como as worktrees ficam em um diretório diferente do seu projeto original, **sistemas de build ou ferramentas que dependem de caminhos relativos** (p. ex., referências a `../shared-lib`, dependências com links simbólicos ou dependências de código-fonte em monorepo resolvidas por caminho) podem deixar de funcionar dentro de uma worktree. Se o seu projeto usa caminhos relativos fora da raiz do repositório, configure um [hook `post_setup_worktree`](https://docs.devinenterprise.com/pt-BR/desktop/cascade#setup-hook) para criar os links simbólicos necessários ou copiar os arquivos exigidos para os locais esperados.

### Hook de configuração

Cada worktree contém uma cópia dos arquivos do seu repositório, mas não inclui arquivos `.env` nem outros pacotes que não estejam sob controle de versão.

Se quiser incluir arquivos ou pacotes adicionais em cada worktree, você pode usar o hook `post_setup_worktree` para copiá-los para o diretório da worktree.

O hook `post_setup_worktree` é executado depois que cada worktree é criada e configurada, dentro do diretório da nova **worktree**.

A variável de ambiente `$ROOT_WORKSPACE_PATH` aponta para o caminho original do workspace e pode ser usada para acessar arquivos ou executar comandos em relação ao repositório original.

#### Exemplo

Copie os arquivos de ambiente e instale as dependências quando uma nova worktree for criada.

**Configuração** (em `.windsurf/hooks.json`):

```json theme={null}
{
  "hooks": {
    "post_setup_worktree": [
      {
        "command": "bash $ROOT_WORKSPACE_PATH/hooks/setup_worktree.sh",
        "show_output": true
      }
    ]
  }
}
```

**Script** (`hooks/setup_worktree.sh`):

```bash theme={null}
#!/bin/bash

# Copiar arquivos de ambiente do workspace original
if [ -f "$ROOT_WORKSPACE_PATH/.env" ]; then
    cp "$ROOT_WORKSPACE_PATH/.env" .env
    echo "Copied .env file"
fi

if [ -f "$ROOT_WORKSPACE_PATH/.env.local" ]; then
    cp "$ROOT_WORKSPACE_PATH/.env.local" .env.local
    echo "Copied .env.local file"
fi

# Instalar dependências
if [ -f "package.json" ]; then
    npm install
    echo "Installed npm dependencies"
fi

exit 0
```

Este hook garante que cada worktree tenha a configuração de ambiente necessária e que as dependências sejam instaladas automaticamente.

### Limpeza

O Devin Desktop limpa automaticamente as worktrees mais antigas ao criar uma nova worktree, para evitar o uso excessivo de disco. Cada workspace pode ter até **20** worktrees.

A limpeza das worktrees é feita com base no último acesso: as mais antigas são removidas primeiro. Essa limpeza ocorre por workspace, garantindo que as worktrees de repositórios diferentes permaneçam independentes entre si.

Além disso, se você excluir manualmente uma conversa no Cascade, o Devin Desktop excluirá automaticamente a worktree associada.

### Painel de controle de código-fonte

Por padrão, o Devin Desktop não exibe no painel de SCM as worktrees criadas pelo Cascade.
Para alterar esse comportamento e exibir as worktrees no painel de SCM, defina `git.showDevinWorktrees` como `true` nas suas configurações.

> [!NOTE]
>
> A configuração antiga `git.showWindsurfWorktrees` está obsoleta. Ela ainda é respeitada em configurações existentes quando `git.showDevinWorktrees` não está definida, mas, daqui em diante, use `git.showDevinWorktrees`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.