> ## 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.

# Comandi e flag

> Riferimento completo per gli argomenti dei comandi, i sottocomandi e i comandi slash interattivi

<div id="usage">
  ## Utilizzo
</div>

```bash theme={null}
devin [OPTIONS] [prompt]
```

Specifica un prompt facoltativo per avviare una sessione con un messaggio iniziale, oppure avvia in modo interattivo senza argomenti.

Puoi anche consultarli dal terminale con `man devin`.

***

<div id="global-flags">
  ## Flag globali
</div>

| Flag                        | Short | Description                                                                                                                  |
| --------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------- |
| `--model <MODEL>`           |       | Imposta il modello AI per questa sessione                                                                                    |
| `--permission-mode <MODE>`  |       | Modalità di autorizzazione (`normal`, `dangerous`, `bypass`)                                                                 |
| `--continue`                | `-c`  | Riprende la sessione più recente nella directory corrente                                                                    |
| `--resume <SESSION_ID>`     | `-r`  | Riprende una sessione specifica in base all'ID                                                                               |
| `--print [PROMPT]`          | `-p`  | Stampa la risposta ed esce (modalità non interattiva). Accetta facoltativamente un prompt inline.                            |
| `--prompt-file <FILE>`      |       | Carica il prompt iniziale da un file                                                                                         |
| `--config <PATH>`           |       | Percorso del file di configurazione                                                                                          |
| `--export [PATH]`           |       | Esporta la conversazione in un file dopo ogni turno (formato ATIF). Usa un percorso predefinito se non ne viene fornito uno. |
| `--respect-workspace-trust` |       | Determina se rispettare le impostazioni di attendibilità del workspace                                                       |

**Esempi:**

```bash theme={null}
devin -- add a login page
devin --model opus -- refactor the auth module
devin -c                              # Riprendi l'ultima sessione
devin -r abc12345                     # Riprendi una sessione specifica
devin -p "list all TODO comments"    # Stampa la risposta ed esci
devin -p -- list all TODO comments    # Equivalente, usando il separatore -- (funziona ugualmente)
devin --export -- fix the tests       # Esporta la conversazione nel percorso predefinito
devin --export out.json -- fix tests   # Esporta in un file specifico
```

***

<div id="subcommands">
  ## Sottocomandi
</div>

<div id="devin-auth">
  ### devin auth
</div>

Comandi relativi all'autenticazione.

| Comando             | Descrizione                                        |
| ------------------- | -------------------------------------------------- |
| `devin auth login`  | Accedi al tuo account                              |
| `devin auth logout` | Disconnettiti e rimuovi le credenziali memorizzate |
| `devin auth status` | Verifica lo stato dell'autenticazione              |

**Opzioni per `devin auth login`:**

* `--force-manual-token-flow` — Salta l'autenticazione tramite browser e incolla manualmente un token (utile per sessioni remote/SSH)

<div id="devin-mcp">
  ### devin mcp
</div>

Connettiti e accedi ai server Model Context Protocol.

| Comando                    | Descrizione                                                |
| -------------------------- | ---------------------------------------------------------- |
| `devin mcp add <name>`     | Aggiunge un nuovo server MCP                               |
| `devin mcp list`           | Elenca tutti i server MCP configurati                      |
| `devin mcp get <name>`     | Mostra i dettagli di un server MCP specifico               |
| `devin mcp remove <name>`  | Rimuove un server MCP configurato                          |
| `devin mcp login <name>`   | Esegue l'autenticazione con un server MCP tramite OAuth    |
| `devin mcp logout <name>`  | Rimuove le credenziali OAuth memorizzate per un server MCP |
| `devin mcp enable <name>`  | Abilita un server MCP disabilitato                         |
| `devin mcp disable <name>` | Disabilita un server MCP senza rimuoverlo                  |

**Opzioni per `devin mcp add`:**

* `-t, --transport <stdio|http>` — Tipo di trasporto (facoltativo; dedotto dall'URL → http, dagli argomenti successivi → stdio)
* `-s, --scope <local|project|user>` — Ambito di configurazione (predefinito: `local`)
* `--url <URL>` — URL per il trasporto HTTP (può anche essere passato come argomento posizionale dopo il nome)
* `--command <CMD>` — Comando per il trasporto stdio (facoltativo quando vengono forniti argomenti successivi)
* `-e, --env <KEY=VALUE>` — Variabili d'ambiente (ripetibile)
* `-H, --header <HEADER: VALUE>` — Intestazioni HTTP (ripetibile)
* `--scopes <SCOPE,SCOPE>` — Ambiti OAuth da richiedere (separati da virgole)
* `<URL>` — Argomento URL posizionale per HTTP (alternativa a `--url`)
* `-- <COMMAND> [ARGS...]` — Comando e argomenti per stdio (il primo argomento è il comando quando `--command` viene omesso)

<Note>
  I server HTTP tentano prima Streamable HTTP e, in caso di errori 4xx, ripiegano su SSE legacy (come indicato nella [spec MCP](https://spec.modelcontextprotocol.io/specification/2025-03-26/basic/transports/#backwards-compatibility)). Puoi anche impostare esplicitamente `"transport": "sse"`. Vedi [Configurazione MCP → Risoluzione dei problemi](/it/cli/extensibility/mcp/configuration#troubleshooting).
</Note>

**Esempi:**

```bash theme={null}
# server stdio
devin mcp add my-server -- npx @company/mcp-server --port 3000

# server HTTP (URL posizionale)
devin mcp add notion https://mcp.notion.com/mcp
devin mcp add --transport http datadog-mcp https://mcp.datadoghq.com/api/unstable/mcp-server/mcp

# server HTTP (flag --url, funziona anche questa)
devin mcp add notion --url https://mcp.notion.com/mcp

# Con variabili d'ambiente e ambito
devin mcp add -e GITHUB_TOKEN=ghp_xxx github -- npx -y @modelcontextprotocol/server-github
devin mcp add -s project sentry https://mcp.sentry.dev/mcp
```

**Opzioni per `devin mcp remove`:**

* `-s, --scope <local|project|user>` — Ambito di configurazione (predefinito: `local`)

**Opzioni per `devin mcp login`:**

* `--scopes <SCOPE,SCOPE>` — Ambiti OAuth da richiedere (separati da virgole)

**Opzioni per `devin mcp enable`:**

* `-s, --scope <local|project|user>` — Ambito di configurazione (predefinito: `local`)

**Opzioni per `devin mcp disable`:**

* `-s, --scope <local|project|user>` — Ambito di configurazione (predefinito: `local`)

Per i dettagli, vedi [Configurazione MCP](/it/cli/extensibility/mcp/configuration).

<div id="devin-rules">
  ### devin rules
</div>

Gestisci le regole dell'agente (blocchi di contesto sempre attivi).

| Comando                   | Descrizione                                    |
| ------------------------- | ---------------------------------------------- |
| `devin rules list`        | Elenca tutte le regole disponibili             |
| `devin rules show <name>` | Mostra i dettagli di una regola specifica      |
| `devin rules paths`       | Mostra i percorsi delle directory delle regole |

**Opzioni per `devin rules list`:**

* `--provider <cursor\|windsurf>` — Filtra per provider di regole

Per i dettagli, vedi [Regole](/it/cli/extensibility/rules).

<div id="devin-skills">
  ### devin skills
</div>

Gestisci le skill dell'agente (comandi slash e blob di contesto attivati dall'agente).

| Comando                    | Descrizione                                   |
| -------------------------- | --------------------------------------------- |
| `devin skills list`        | Elenca tutte le skill disponibili             |
| `devin skills show <name>` | Mostra i dettagli di una skill specifica      |
| `devin skills paths`       | Mostra i percorsi delle directory delle skill |

**Opzioni per `devin skills list`:**

* `--trigger <user\|model>` — Filtra per tipo di trigger

Per maggiori dettagli, vedi [Skills](/it/cli/extensibility/skills/overview).

<div id="devin-list">
  ### devin list
</div>

Elenca le sessioni nella directory corrente. Alias: `devin ls`

| Comando                    | Descrizione                                     |
| -------------------------- | ----------------------------------------------- |
| `devin list`               | Selettore interattivo di sessioni (predefinito) |
| `devin list --format json` | Restituisce le sessioni in formato JSON         |
| `devin list --format csv`  | Restituisce le sessioni in formato CSV          |

<div id="devin-version">
  ### devin version
</div>

Stampa la versione corrente ed esce.

```bash theme={null}
devin version
```

Equivale a `devin --version`.

<div id="devin-acp">
  ### devin acp
</div>

Esegue Devin come server [Agent Client Protocol (ACP)](https://agentclientprotocol.com/) su stdio. Questo sottocomando è concepito per essere invocato da un editor o IDE compatibile con ACP (come Windsurf o Zed) come sottoprocesso: comunica tramite JSON-RPC su stdin/stdout e non è pensato per l'esecuzione interattiva.

```bash theme={null}
devin acp
```

Il server ACP legge le credenziali da `WINDSURF_API_KEY` se è impostata; altrimenti, usa le credenziali memorizzate da `devin auth login`. Può anche accettare credenziali in fase di esecuzione tramite la request ACP `authenticate`.

<div id="devin-update">
  ### devin update
</div>

Verifica se sono disponibili aggiornamenti e, facoltativamente, installali.

```bash theme={null}
devin update
```

Usa `--force` per reinstallare anche se hai già l'ultima versione installata:

```bash theme={null}
devin update --force
```

<div id="devin-shell">
  ### devin shell
</div>

\[Funzionalità in anteprima] Comandi di integrazione della shell. Per tutti i dettagli, consulta [Integrazione della shell](/it/cli/shell-integration).

| Comando                     | Descrizione                                                                |
| --------------------------- | -------------------------------------------------------------------------- |
| `devin shell setup`         | Installa l'integrazione della shell nel file di configurazione della shell |
| `devin shell setup <shell>` | Installa l'integrazione per una shell specifica (`bash`, `zsh` o `fish`)   |

<div id="devin-sandbox">
  ### devin sandbox
</div>

\[Anteprima di ricerca] Gestisci l'isolamento in sandbox dei processi a livello di sistema operativo per lo strumento exec. Passa il flag globale `--sandbox` per avviare una sessione con il sandbox attivo.

<div id="devin-sandbox-setup">
  #### devin sandbox setup
</div>

Mostra i prerequisiti della sandbox per la piattaforma corrente.

Requisiti per il run con `--sandbox`:

* **Linux**: richiede bubblewrap (`bwrap`) e `socat`. Se manca uno dei due, una sessione sandbox non riesce ad avviarsi e vengono mostrate le istruzioni di installazione, anche in una distribuzione WSL appena installata.
* **macOS**: funziona subito tramite Seatbelt; non richiede pacchetti aggiuntivi.
* **Windows**: Windows nativo non può eseguire la sandbox. [Installa WSL 2](https://learn.microsoft.com/windows/wsl/install) ed esegui Devin all'interno della distribuzione WSL.

```bash theme={null}
devin sandbox setup
```

<div id="devin-setup">
  ### devin setup
</div>

Procedura guidata interattiva per configurare l'autenticazione e MCP.

```bash theme={null}
devin setup
devin setup --force-manual-token-flow  # Per sessioni remote/SSH
```

<div id="devin-uninstall">
  ### devin uninstall
</div>

Disinstalla Devin CLI e, facoltativamente, rimuovi tutti i dati.

| Opzione   | Descrizione                                                                    |
| --------- | ------------------------------------------------------------------------------ |
| `--clean` | Rimuovi tutti i dati, inclusi configurazione, cronologia e dati personalizzati |
| `--force` | Ignora la richiesta di conferma                                                |

***

<div id="slash-commands">
  ## Comandi slash
</div>

Questi comandi sono disponibili all'interno di una sessione interattiva. Digitateli nel prompt.

<div id="mode-model">
  ### Modalità e modello
</div>

| Comando                                                         | Descrizione                                                                                   |      |           |                                                                                          |
| --------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | ---- | --------- | ---------------------------------------------------------------------------------------- |
| \`/mode \[normal                                                | accept-edits                                                                                  | plan | bypass]\` | Mostra o cambia la modalità corrente (`autonomous` è disponibile nelle sessioni sandbox) |
| `/normal`                                                       | Passa alla modalità Normal (predefinita)                                                      |      |           |                                                                                          |
| `/accept-edits`                                                 | Passa alla modalità Accept Edits (approva automaticamente le modifiche ai file nel workspace) |      |           |                                                                                          |
| `/plan`                                                         | Passa alla modalità Plan (pianificazione in sola lettura)                                     |      |           |                                                                                          |
| `/ask <question>`                                               | Poni una domanda senza apportare modifiche al codice (oneshot)                                |      |           |                                                                                          |
| `/bypass`                                                       | Passa alla modalità Bypass (approva automaticamente tutte le action)                          |      |           |                                                                                          |
| `/model [name]`                                                 | Mostra o cambia il modello corrente                                                           |      |           |                                                                                          |
| `/fast`                                                         | Passa a SWE-1.6 Fast                                                                          |      |           |                                                                                          |
| `/theme [dark\|light\|terminal-dark\|terminal-light\|no-color]` | Passa da un tema all'altro (scuro, chiaro, terminale scuro, terminale chiaro, senza colore)   |      |           |                                                                                          |

<Note>
  `/bypass` ha gli alias `/yolo` e `/dangerous`. Tutti e tre fanno la stessa cosa.
</Note>

<div id="session-management">
  ### Gestione delle sessioni
</div>

| Command                       | Descrizione                                                                                                                                  |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `/clear`                      | Cancella la cronologia della conversazione e avvia una nuova sessione. Alias: `/new`                                                         |
| `/continue [session-id]`      | Riprendi una sessione precedente                                                                                                             |
| `/fork [step]`                | Crea un fork della sessione corrente in una nuova sessione. Facoltativamente, puoi creare il fork da un passaggio specifico (vedi `/steps`). |
| `/steps`                      | Elenca i passaggi della conversazione (da usare con `/fork` e `/revert`)                                                                     |
| `/revert <step>`              | Annulla le modifiche ai file da un passaggio specifico in poi e riporta la conversazione a prima di quel passaggio                           |
| `/resume [session-id]`        | Apri il selettore interattivo delle sessioni oppure riprendi una sessione specifica tramite ID                                               |
| `/ls [--all]`                 | Elenca le sessioni recenti (per impostazione predefinita, solo nella directory corrente). Alias: `/list-sessions`                            |
| `/rename-session <new title>` | Rinomina la sessione corrente                                                                                                                |
| `/rm-session <session-id>`    | Elimina in modo irreversibile una sessione e tutti i suoi dati                                                                               |
| `/export`                     | Mostra le informazioni di esportazione. Usa il flag CLI `--export` per abilitare l'esportazione della conversazione.                         |
| `/exit`                       | Esci dall'applicazione (alias: `/quit`). Puoi anche digitare `exit` o `quit` senza il prefisso `/`.                                          |

<div id="workspace">
  ### Workspace
</div>

| Comando                | Descrizione                                              |
| ---------------------- | -------------------------------------------------------- |
| `/workspace`           | Elenca le directory del workspace (alias: `/workspaces`) |
| `/add-dir <path>`      | Aggiunge un'ulteriore directory del workspace            |
| `/undo-add-dir <path>` | Rimuove una directory del workspace                      |

<div id="automation">
  ### Automazione
</div>

| Comando          | Descrizione                                                                                                                                                                                             |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/loop <prompt>` | Esegui un prompt, quindi esegui in loop la revisione automatica del diff                                                                                                                                |
| `/btw <prompt>`  | Fai una rapida domanda secondaria. Esegue una sidechain usando il contesto della conversazione corrente e mostra la risposta in un riquadro, senza aggiungere la domanda alla conversazione principale. |

<div id="extensibility">
  ### Estensibilità
</div>

| Comando  | Descrizione                                                                          |
| -------- | ------------------------------------------------------------------------------------ |
| `/hooks` | Elenca tutti gli hook caricati con i relativi ID, tipi di evento e percorsi sorgente |

<div id="utilities">
  ### Utilità
</div>

| Comando              | Descrizione                                                                                                                    |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `/help`              | Mostra i comandi slash disponibili                                                                                             |
| `/shortcuts`         | Sfoglia le scorciatoie da tastiera in un elenco interattivo, ricercabile e raggruppato per categoria                           |
| `/bug [description]` | Segnala un bug agli sviluppatori della Devin CLI                                                                               |
| `/update [--force]`  | Verifica e installa gli aggiornamenti. Usa `--force` per reinstallare anche se è già installata la versione più recente.       |
| `/upgrade`           | Passa a un piano di abbonamento superiore                                                                                      |
| `/login`             | Accedi con il tuo account                                                                                                      |
| `/logout`            | Cancella le credenziali memorizzate ed esci                                                                                    |
| `/context`           | Mostra l'utilizzo della finestra di contesto                                                                                   |
| `/usage`             | Mostra l'utilizzo stimato di crediti/ACU per la sessione, incluso l'utilizzo delle precedenti aperture di una sessione ripresa |
| `/compact`           | Forza la compattazione della conversazione                                                                                     |

<div id="cloud-sessions-insiders-only">
  ### Sessioni cloud (solo insiders)
</div>

| Comando                      | Descrizione                                                                                                                                                                                                                     |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/cloud-sessions [--all]`    | Apri un selettore interattivo delle tue sessioni recenti su cloud Devin. Usa i tasti freccia per spostarti, digita per filtrare, premi Invio per collegarti, Esc per annullare. Passa `--all` per le sessioni a livello di org. |
| `/cloud-attach <session-id>` | Collegati a una sessione di cloud Devin con rendering TUI completo e input bidirezionale.                                                                                                                                       |

***

<div id="modes">
  ## Modalità
</div>

Le modalità controllano il livello di autonomia dell'agente combinando una modalità di autorizzazione con un profilo dell'agente.

<Tabs>
  <Tab title="Normal (predefinita)">
    Autonomia completa per attività di coding complesse. L'agente può leggere, scrivere ed eseguire comandi con i normali controlli di autorizzazione.

    * **Permission mode:** Normal
    * **Profile:** Normal
    * **Use for:** Refactor su più file, implementazione di funzionalità, correzioni di bug
  </Tab>

  <Tab title="Plan">
    Solo pianificazione: l'agente propone modifiche senza applicarle. L'accesso agli strumenti in sola lettura garantisce che il codice non venga modificato.

    * **Permission mode:** Normal
    * **Profile:** Plan (strumenti in sola lettura)
    * **Use for:** Progettazione dell'architettura, comprensione delle codebase, pianificazione prima dell'implementazione
  </Tab>

  <Tab title="Bypass">
    Tutte le richieste di autorizzazione vengono approvate automaticamente. L'agente esegue liberamente senza chiedere conferma.

    * **Permission mode:** Dangerous
    * **Profile:** Normal
    * **Use for:** Attività affidabili in cui le interruzioni ti rallentano

    <Warning>
      Usa la modalità Bypass solo per attività di cui ti fidi completamente. Tutte le chiamate agli strumenti, inclusi i comandi distruttivi, vengono approvate automaticamente.
    </Warning>
  </Tab>
</Tabs>

Passa da una modalità all'altra con `/mode`, oppure passa direttamente a `/normal`, `/accept-edits`, `/plan` o `/bypass`. Usa `/ask <question>` come comando oneshot per fare domande senza cambiare modalità.

***

<div id="profiles">
  ## Profili
</div>

I profili determinano gli strumenti a disposizione dell'agente e il suo comportamento. I profili vengono impostati automaticamente quando si cambia modalità.

| Profilo  | Descrizione                                                                        | Accesso agli strumenti                                                                    |
| -------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `normal` | Assistente di coding completo (usato dalle modalità Normal, Accept Edits e Bypass) | Tutti gli strumenti                                                                       |
| `plan`   | Flusso di lavoro di pianificazione strutturato (usato dalla modalità Plan)         | Strumenti in sola lettura (grep, glob, read, todo, ask\_user\_question, exit\_plan\_mode) |
| `ask`    | Risposte a domande (usato dal comando `/ask`)                                      | Strumenti in sola lettura (grep, glob, read, todo, ask\_user\_question)                   |
