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

# Cascade (legacy)

> Riferimento per l'agente legacy Cascade in Devin Desktop: modalità, memorie e regole, skill, AGENTS.md, flussi di lavoro, alberi di lavoro, MCP e hook.

> [!NOTE]
>
> Cascade è l'agente legacy di Devin Desktop. Devin Desktop non avvia più nuove conversazioni di Cascade e non riapre più quelle precedenti. Le nuove conversazioni vengono avviate con [Devin Local](https://docs.devin.ai/it/desktop/devin-local/overview.md).

## Panoramica

Cascade di Devin Desktop porta la collaborazione tra persone e AI a un nuovo livello.

Prima di [Devin Local](https://docs.devin.ai/it/desktop/devin-local/overview.md), Cascade era l'agente locale di Devin Desktop. Cascade non è più disponibile nel selettore dell'agente.

> [!NOTE]
>
> Devin Local e tutti gli altri agenti ACP non sono disponibili quando un workspace è aperto in Modalità con restrizioni.

##### Collegamenti rapidi alle funzionalità

> [card] [Terminal](https://docs.devin.ai/it/desktop/terminal.md)
>
> Un'esperienza Terminal potenziata.

> [card] [Flussi di lavoro](https://docs.devin.ai/it/desktop/cascade.md#workflows)
>
> Automatizza le traiettorie ripetitive.

### Selezione del modello

Seleziona il modello desiderato dal menu di selezione sotto il campo di input della conversazione di Cascade. Fai clic qui sotto per consultare l'elenco completo dei modelli disponibili e la loro disponibilità nei diversi piani e fasce di prezzo.

> [card] [Modelli](https://docs.devin.ai/it/desktop/models.md)
>
> Disponibilità dei modelli in Devin Desktop.

### Cascade Code / Cascade Chat

Cascade offre due modalità principali: **Code** e **Chat**.

La modalità Code consente a Cascade di creare e modificare il codice della tua codebase, mentre la modalità Chat è ottimizzata per rispondere a domande sulla tua codebase o sui principi generali di programmazione.

In modalità Chat, Cascade può proporti nuovo codice che puoi accettare e inserire.

### Piani ed elenchi Todo

Cascade dispone di funzionalità di pianificazione integrate che contribuiscono a migliorare le prestazioni nelle attività più lunghe.

In background, un agente di pianificazione specializzato perfeziona di continuo il piano a lungo termine, mentre il modello che hai selezionato si concentra sulle azioni a breve termine previste da quel piano.

Cascade crea un elenco Todo all'interno della conversazione per monitorare l'avanzamento delle attività complesse. Per modificare il piano, ti basta chiedere a Cascade di aggiornare l'elenco Todo.

Cascade può anche aggiornare automaticamente il piano man mano che acquisisce nuove informazioni nel corso di una conversazione, ad esempio una Memoria.

### Messaggi in coda

Mentre attendi che Cascade completi l'attività attuale, puoi mettere in coda nuovi messaggi, che verranno eseguiti in ordine al termine dell'attività.

Per aggiungere un messaggio alla coda, digitalo mentre Cascade è in esecuzione e premi `Enter`.

* **Invia subito**: premi di nuovo Enter con la casella di testo vuota per inviarlo immediatamente.
* **Elimina**: rimuovi un messaggio qualsiasi dalla coda prima che venga inviato

### Chiamata agli strumenti

Cascade ha a disposizione diversi strumenti, come Search, Analyze, MCP e il [terminale](https://docs.devin.ai/it/desktop/terminal.md).

È in grado di rilevare quali pacchetti e strumenti stai utilizzando, quali devono essere installati e persino di installarli al posto tuo. Ti basta chiedere a Cascade come eseguire il tuo progetto e premere Accept.

> [!NOTE]
>
> Per impostazione predefinita, Cascade può effettuare fino a 40 invocazioni per prompt. Se la traiettoria si interrompe al raggiungimento di questo limite, premi il pulsante `continue` e Cascade riprenderà da dove si era interrotto. Tuttavia, a causa dei costi della chiamata agli strumenti, ogni `continue` verrà conteggiato come un nuovo credito di prompt.

Puoi attivare l'impostazione `Auto-Continue` per fare in modo che Cascade prosegua automaticamente la risposta, anziché fermarsi, quando raggiunge il limite di invocazioni. Questo consumerà uno o più crediti di prompt in base al modello che stai utilizzando.

In `settings.json`, corrisponde all'impostazione `devin.autoContinue`: `0` o un valore negativo attiva la continuazione automatica, per cui Cascade prosegue senza limiti, mentre un valore positivo (il predefinito è `40`) la disattiva, per cui Cascade si ferma al limite di invocazioni e ti chiede se continuare.

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

### Input vocale

Usa l'input vocale per interagire con Cascade tramite la tua voce. Nella sua versione attuale, consente di trascrivere in testo ciò che dici.

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

### Punti di ripristino con nome e ripristini

Puoi annullare le modifiche apportate da Cascade. Ti basta passare il mouse sul prompt originale e fare clic sulla freccia di ripristino a destra, oppure ripristinare direttamente dall'indice. In questo modo tutte le modifiche al codice verranno annullate, riportando la tua codebase allo stato in cui si trovava al passaggio desiderato.

> [!WARNING]
>
> Al momento i ripristini sono irreversibili, quindi fai attenzione!

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

Puoi anche creare, direttamente dalla conversazione, uno snapshot/punto di ripristino con nome dello stato attuale del tuo progetto, a cui potrai tornare facilmente e da cui potrai ripristinare in qualsiasi momento.

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

### Consapevolezza in tempo reale

Una funzionalità unica di Devin Desktop e Cascade è la consapevolezza in tempo reale delle tue azioni: non serve più includere nel prompt il contesto su ciò che hai fatto in precedenza.

Ti basta scrivere a Cascade: «Continua».

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

### Inviare i problemi all'agente

Quando il tuo codice presenta problemi che compaiono nel pannello Problems in fondo all'editor, puoi inviarli all'agente come contesto:

* Fai clic su `Send all to agent` in cima al pannello Problems per inviare tutti i problemi attualmente elencati.
* Fai clic su `Send to agent` accanto a un file nel pannello Problems per inviare solo i problemi di quel file.

### Spiega e correggi

Per qualsiasi errore che incontri nell'editor, ti basta selezionarlo e fare clic su `Explain and Fix` per farlo correggere a Cascade.

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

### Ignorare i file

Se vuoi che Cascade ignori determinati file, puoi aggiungerli a `.devinignore` (o al file legacy `.codeiumignore`) nella root del tuo workspace. In questo modo Cascade non potrà visualizzare, modificare o creare file all'interno dei percorsi indicati. Puoi specificare i percorsi dei file con un formato simile a quello di `.gitignore`. Per maggiori dettagli, consulta [Ignorare i file](https://docs.devin.ai/it/desktop/context-awareness/devin-ignore.md).

#### .codeiumignore globale

Per i clienti aziendali che gestiscono più repository, è possibile imporre regole di esclusione su tutti i repository inserendo un file `.codeiumignore` globale nella cartella `~/.codeium/`. Questa configurazione globale si applica a tutti i workspace di Devin Desktop sul tuo sistema e si aggiunge a eventuali file `.codeiumignore` specifici dei singoli repository.

### Integrazione con i linter

Cascade può correggere automaticamente gli errori di lint nel codice generato. Questa funzionalità è attiva per impostazione predefinita, ma puoi disabilitarla facendo clic su `Auto-fix` nella tool call e poi su `disable`. Queste modifiche non consumano crediti.

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

Quando Cascade apporta una modifica allo scopo principale di correggere errori di lint che ha introdotto e rilevato automaticamente,
può renderla gratuita, senza addebito di crediti. Questo perché
la correzione degli errori di lint aumenta il numero di chiamate agli strumenti effettuate da Cascade.

### Condividere la tua conversazione

I collegamenti condivisi alle conversazioni di Cascade non funzionano più. Devin Desktop ha rimosso le pagine di condivisione delle conversazioni di Cascade.

### Menzione con @ delle conversazioni precedenti

Puoi anche fare riferimento a conversazioni precedenti all'interno di altre conversazioni tramite una `@-mention`.

In questo caso, Cascade recupererà le informazioni più pertinenti e utili, come i riepiloghi e i punti di ripristino delle conversazioni, oltre alle parti specifiche della conversazione che richiedi. In genere non recupera l'intera conversazione, per non sovraccaricare la finestra di contesto.

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

### Cascade simultanei

Gli utenti possono avere più Cascade in esecuzione contemporaneamente. Puoi passare dall'uno all'altro tramite il menu a discesa in alto a sinistra del pannello Cascade.

> [!WARNING]
>
> Se due Cascade modificano lo stesso file nello stesso momento, le modifiche possono entrare in conflitto e talvolta la seconda non andrà a buon fine.

Se prevedi che due Cascade modifichino file simili, valuta l'uso degli [alberi di lavoro](https://docs.devin.ai/it/desktop/cascade.md#worktrees) per mantenerli isolati.

## Flussi di lavoro

I flussi di lavoro consentono agli utenti di definire una serie di passaggi per guidare Cascade nello svolgimento di attività ripetitive, come la distribuzione di un servizio o la risposta ai commenti sulle PR.

I flussi di lavoro vengono salvati come file markdown e offrono agli utenti e ai loro team un modo semplice e ripetibile per eseguire i processi chiave.

Una volta salvati, i flussi di lavoro possono essere invocati in Cascade tramite un comando slash nel formato `/[name-of-workflow]`.

> [!NOTE]
>
> I flussi di lavoro sono **esclusivamente manuali**: Cascade non invocherà mai un flusso di lavoro in automatico. Se vuoi che Cascade applichi una procedura in autonomia, usa invece una [Skill](https://docs.devin.ai/it/desktop/devin-local/customizations.md#skills).

I flussi di lavoro sono specifici di Cascade: [Devin Local](https://docs.devin.ai/it/desktop/devin-local/overview.md) non li supporta. Migra i tuoi flussi di lavoro alle [skill](https://docs.devin.ai/it/desktop/devin-local/customizations.md#skills).

### Come funziona

In genere, le regole forniscono indicazioni ai modelli linguistici di grandi dimensioni offrendo un contesto persistente e riutilizzabile a livello di prompt.

I flussi di lavoro estendono questo concetto fornendo una sequenza strutturata di passaggi o prompt a livello di traiettoria, che guida il modello attraverso una serie di attività o azioni interconnesse.

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

Per eseguire un flusso di lavoro, basta invocarlo in Cascade con il comando `/[workflow-name]`.

> [!TIP]
>
> Puoi richiamare altri flussi di lavoro all'interno di un flusso di lavoro! \
> \
> Ad esempio, /workflow-1 può includere istruzioni come "Call /workflow-2" e "Call /workflow-3".

Una volta invocato il flusso di lavoro, Cascade elabora in sequenza ogni passaggio definito, eseguendo azioni o generando risposte secondo quanto specificato.

### Come creare un flusso di lavoro

Per iniziare a usare i flussi di lavoro, fai clic sull'icona `Customizations` nel menu a scorrimento laterale in alto a destra in Cascade, quindi apri il pannello `Workflows`. Qui puoi fare clic sul pulsante `+ Global` o `+ Workspace` per creare un nuovo flusso di lavoro, rispettivamente a livello globale o di workspace.

I flussi di lavoro vengono salvati come file Markdown nelle directory `.devin/workflows/` (o nella directory legacy `.windsurf/workflows/`) e contengono un titolo, una descrizione e una serie di passaggi con istruzioni specifiche che Cascade deve seguire.

### Rilevamento dei flussi di lavoro

Devin Desktop rileva automaticamente i flussi di lavoro in più posizioni, offrendo un'organizzazione flessibile:

* **Workspace attuale e sottodirectory**: tutte le directory `.devin/workflows/` (e le directory legacy `.windsurf/workflows/`) presenti nel tuo workspace attuale e nelle sue sottodirectory
* **Struttura del repository Git**: nei repository Git, Devin Desktop risale anche fino alla directory radice Git per cercare flussi di lavoro nelle directory padre
* **Supporto per workspace multipli**: quando nello stesso workspace sono aperte più cartelle, i flussi di lavoro vengono deduplicati e mostrati con il percorso relativo più breve

#### Posizioni di archiviazione dei flussi di lavoro

| Ambito | Posizione | Note |
| - | - | - |
| Workspace | `.devin/workflows/*.md` (preferita) o `.windsurf/workflows/*.md` (fallback) | Nel tuo workspace attuale, in qualsiasi sottodirectory o in qualsiasi directory padre fino alla directory radice Git. Salvati in un commit nel tuo repo. |
| Globale | `~/.codeium/windsurf/global_workflows/*.md` | Disponibili in ogni workspace sulla tua macchina. Non salvati in un commit. |
| Integrato | Gestiti da Devin Desktop | Template inclusi in Devin Desktop (ad es. `/plan`). |
| [Sistema (Enterprise)](#system-level-workflows-enterprise) | Dipende dal sistema operativo (ad es. `/etc/devin/workflows/`, legacy `/etc/windsurf/workflows/`) | Distribuiti dal reparto IT, in sola lettura per gli utenti finali. |

Quando crei un nuovo flusso di lavoro tramite la UI, questo viene salvato nella directory `.devin/workflows/` del tuo workspace attuale, non necessariamente nella directory radice Git. Se hai rifiutato la migrazione per un workspace che contiene ancora una directory `.windsurf/`, viene invece salvato in `.windsurf/workflows/`. Per creare un flusso di lavoro globale, usa il pulsante `+ Global` nel pannello dei flussi di lavoro oppure crea il file direttamente in `~/.codeium/windsurf/global_workflows/`.

Ogni file di flusso di lavoro può contenere al massimo 12000 caratteri.

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

#### Generare un flusso di lavoro con Cascade

Puoi anche chiedere a Cascade di generare flussi di lavoro per te! Funziona particolarmente bene con i flussi di lavoro che prevedono una serie di passaggi in un determinato strumento CLI.

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

### Esempi di flussi di lavoro

I flussi di lavoro si prestano a moltissimi casi d'uso, ad esempio:

> [card] /address-pr-comments
>
> Questo è un flusso di lavoro che il nostro team usa internamente per gestire i commenti sulle PR:
>
> ```
> 1. Check out the PR branch: `gh pr checkout [id]`
>
> 2. Get comments on 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. For EACH comment, do the following. Remember to address one comment at a time.
>  a. Print out the following: "(index). From [user] on [file]:[lines] — [body]"
>  b. Analyze the file and the line range.
>  c. If you don't understand the comment, do not make a change. Just ask me for clarification, or to implement it myself.
>  d. If you think you can make the change, make the change BEFORE moving onto the next comment.
>
> 4. After all comments are processed, summarize what you did, and which comments need the USER's attention.
> ```

> [card] /git-workflows
>
> Esegui i commit con formati predefiniti e crea pull request con titoli e descrizioni standardizzati tramite i comandi CLI appropriati.

> [card] /dependency-management
>
> Automatizza l'installazione o l'aggiornamento delle dipendenze del progetto a partire da un file di configurazione (ad es. requirements.txt, package.json).

> [card] /code-formatting
>
> Esegui automaticamente formattatori di codice (come Prettier, Black) e linter (come ESLint, Flake8) al salvataggio dei file o prima del commit, per mantenere uno stile di codice coerente e individuare subito gli errori.

> [card] /run-tests-and-fix
>
> Esegui o aggiungi test unitari o end-to-end e correggi automaticamente gli errori per garantire la qualità del codice prima di commit, merge o distribuzione.

> [card] /deployment
>
> Automatizza i passaggi per distribuire la tua applicazione in diversi ambienti (sviluppo, staging, produzione), inclusi gli eventuali controlli pre-distribuzione o verifiche post-distribuzione necessari.

> [card] /security-scan
>
> Integra e avvia scansioni delle vulnerabilità di sicurezza sulla tua codebase all'interno della pipeline CI/CD o su richiesta.

### Flussi di lavoro a livello di sistema (Enterprise)

Le organizzazioni Enterprise possono distribuire flussi di lavoro a livello di sistema, disponibili globalmente in tutti i workspace e non modificabili dagli utenti finali privi di autorizzazioni di amministratore. È la soluzione ideale per applicare a livello di organizzazione processi di sviluppo, procedure di distribuzione e flussi di lavoro di conformità.

I flussi di lavoro a livello di sistema vengono caricati da directory specifiche per ciascun sistema operativo. Devin Desktop carica la directory dei flussi di lavoro `Devin`, se esiste, e ripiega sulla directory legacy dei flussi di lavoro `Windsurf` solo in caso contrario. Il contenuto delle due directory non viene combinato, quindi, quando crei la directory `Devin`, spostaci gli eventuali flussi di lavoro legacy:

**macOS:**

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

**Linux/WSL:**

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

**Windows:**

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

Inserisci i file dei tuoi flussi di lavoro (in formato `.md`) nella directory corrispondente al tuo sistema operativo. Il sistema caricherà automaticamente tutti i file `.md` presenti in queste directory.

#### Precedenza dei flussi di lavoro

Quando esistono flussi di lavoro con lo stesso nome su più livelli, quelli a livello di sistema hanno la precedenza più alta:

1. **Sistema** (priorità più alta) - Flussi di lavoro a livello di organizzazione distribuiti dall'IT
2. **Workspace** - Flussi di lavoro specifici del progetto in `.devin/workflows/` (o nel percorso legacy `.windsurf/workflows/`)
3. **Globale** - Flussi di lavoro definiti dall'utente in `~/.codeium/windsurf/global_workflows/`
4. **Integrato** - Flussi di lavoro predefiniti forniti da Devin Desktop

Di conseguenza, se un'organizzazione distribuisce un flusso di lavoro a livello di sistema con un determinato nome, questo esegue l'override di qualsiasi flusso di lavoro del workspace, globale o integrato con lo stesso nome.

Nell'interfaccia utente di Devin Desktop, i flussi di lavoro a livello di sistema sono contrassegnati dall'etichetta "Sistema" e non possono essere eliminati dagli utenti finali.

> [!NOTE]
>
> **Importante**: i flussi di lavoro a livello di sistema devono essere gestiti dal tuo team IT o dal team di sicurezza. Assicurati che i tuoi team interni gestiscano distribuzione, aggiornamenti e conformità secondo le policy della tua organizzazione. A tale scopo puoi usare strumenti e flussi di lavoro standard come la Gestione dei Dispositivi Mobili (MDM) o la Gestione della Configurazione.

## Alberi di lavoro

Devin Desktop supporta gli alberi di lavoro git per eseguire attività di Cascade in parallelo senza interferire con il tuo workspace principale.

Con gli alberi di lavoro, ogni conversazione di Cascade dispone di una propria sessione, così Cascade può apportare modifiche, eseguire la build e testare il codice senza interferire con il tuo workspace principale.

Anche [Devin Local](https://docs.devin.ai/it/desktop/devin-local/worktrees.md) può avviare una sessione in un albero di lavoro esistente, scelto tramite il selettore della posizione dell'agente, e riportare le modifiche con il pulsante **Merge**.

### Utilizzo di base degli alberi di lavoro

Il modo più semplice per iniziare a usare gli alberi di lavoro è passare alla modalità "Albero di lavoro" nell'angolo in basso a destra del campo di input di Cascade.

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

> [!NOTE]
>
> Al momento puoi passare a un albero di lavoro solo all'inizio di una sessione di Cascade. Una volta avviata, una conversazione non può essere spostata in un altro albero di lavoro.

Dopo che Cascade ha modificato i file nell'albero di lavoro, puoi fare clic su "merge" per riportare tali modifiche nel tuo workspace principale.

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

### Posizione

Gli alberi di lavoro sono organizzati per nome del repo all'interno di `~/.windsurf/worktrees/<repo_name>`.

A ogni albero di lavoro viene assegnato un nome casuale univoco.

Per visualizzare l'elenco degli alberi di lavoro attivi, puoi eseguire `git worktree list` dalla directory del repository.

> [!WARNING]
>
> Poiché gli alberi di lavoro si trovano in una directory diversa da quella del progetto originale, **i sistemi di build o gli strumenti che si basano su percorsi relativi** (ad es. riferimenti a `../shared-lib`, dipendenze collegate tramite collegamento simbolico o dipendenze sorgente di un monorepo risolte tramite percorso) potrebbero non funzionare all'interno di un albero di lavoro. Se il tuo progetto usa percorsi relativi che puntano all'esterno della directory radice del repository, configura un [hook `post_setup_worktree`](https://docs.devin.ai/it/desktop/cascade#setup-hook) per creare i collegamenti simbolici necessari o copiare i file richiesti nelle posizioni previste.

### Hook di configurazione

Ogni worktree contiene una copia dei file del tuo repository, ma non include i file `.env` né altri pacchetti non version-controlled.

Se vuoi includere file o pacchetti aggiuntivi in ogni worktree, puoi usare l'hook `post_setup_worktree` per copiarli nella directory del worktree.

L'hook `post_setup_worktree` viene eseguito dopo la creazione e la configurazione di ogni worktree, all'interno della directory del nuovo **worktree**.

La variabile d'ambiente `$ROOT_WORKSPACE_PATH` punta al percorso del workspace originale e può essere usata per accedere ai file o eseguire comandi a partire dal repository originale.

#### Esempio

Copia i file dell'ambiente e installa le dipendenze quando viene creato un nuovo worktree.

**Config** (in `.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

# Copia i file environment dal workspace originale
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

# Installa le dependencies
if [ -f "package.json" ]; then
    npm install
    echo "Installed npm dependencies"
fi

exit 0
```

Questo hook garantisce che ogni worktree disponga automaticamente della configurazione dell'ambiente necessaria e delle dipendenze richieste.

### Pulizia

Devin Desktop elimina automaticamente gli alberi di lavoro meno recenti quando ne crea uno nuovo, per evitare un uso eccessivo dello spazio su disco. Ogni workspace può contenere fino a **20** alberi di lavoro.

Gli alberi di lavoro vengono eliminati in base all'ultimo accesso: i meno recenti vengono rimossi per primi. La pulizia avviene separatamente per ogni workspace, così gli alberi di lavoro di repository diversi restano indipendenti tra loro.

Inoltre, se elimini manualmente una conversazione di Cascade, Devin Desktop elimina automaticamente l'albero di lavoro associato.

### Pannello Controllo del codice sorgente

Per impostazione predefinita, Devin Desktop non mostra nel pannello SCM gli alberi di lavoro creati da Cascade.
Per cambiare questo comportamento e visualizzare gli alberi di lavoro nel pannello SCM, imposta `git.showDevinWorktrees` su `true` nelle impostazioni.

> [!NOTE]
>
> La vecchia impostazione `git.showWindsurfWorktrees` è deprecata. Viene ancora rispettata nelle configurazioni esistenti se `git.showDevinWorktrees` non è impostata, ma d'ora in poi usa `git.showDevinWorktrees`.


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