Comandi e flag - Devin Docs

Utilizzo

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.

Flag globali

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:

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

Sottocomandi

devin auth

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)

devin mcp

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)
--oauth-resource <RESOURCE> — Override del parametro resource RFC 8707 inviato nelle richieste OAuth (predefinito: l’URL del server MCP; passa una stringa vuota per ometterlo per i provider che lo rifiutano)
<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)

I server HTTP tentano prima Streamable HTTP e, in caso di errori 4xx, ripiegano su SSE legacy (come indicato nella spec MCP). Puoi anche impostare esplicitamente "transport": "sse". Vedi Configurazione MCP → Risoluzione dei problemi.

Esempi:

# 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)
--oauth-resource <RESOURCE> — Override del parametro resource RFC 8707 inviato nelle richieste OAuth (predefinito: l’URL del server MCP; passa una stringa vuota per ometterlo per i provider che lo rifiutano)

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.

devin rules

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.

devin skills

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.

devin list

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

devin version

Stampa la versione corrente ed esce.

devin version

Equivale a devin --version.

devin acp

Esegue Devin come server Agent Client Protocol (ACP) 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.

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.

devin update

Verifica se sono disponibili aggiornamenti e, facoltativamente, installali.

devin update

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

devin update --force

devin shell

[Funzionalità in anteprima] Comandi di integrazione della shell. Per tutti i dettagli, consulta Integrazione della shell.

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`)

devin sandbox

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

devin sandbox setup

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 ed esegui Devin all’interno della distribuzione WSL.

devin sandbox setup

devin setup

Procedura guidata interattiva per configurare l’autenticazione e MCP.

devin setup
devin setup --force-manual-token-flow  # Per sessioni remote/SSH

devin uninstall

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

Comandi slash

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

Modalità e modello

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)

/bypass ha gli alias /yolo e /dangerous. Tutti e tre fanno la stessa cosa.

Gestione delle sessioni

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 `/`.

Workspace

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

Automazione

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.

Estensibilità

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

Utilità

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

Sessioni cloud (solo insiders)

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.

Modalità

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

Normal (predefinita)
Plan
Bypass

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

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

Profili

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)

​Utilizzo

​Flag globali

​Sottocomandi

​devin auth

​devin mcp

​devin rules

​devin skills

​devin list

​devin version

​devin acp

​devin update

​devin shell

​devin sandbox

​devin sandbox setup

​devin setup

​devin uninstall

​Comandi slash

​Modalità e modello

​Gestione delle sessioni

​Workspace

​Automazione

​Estensibilità

​Utilità

​Sessioni cloud (solo insiders)

​Modalità

​Profili

Utilizzo

Flag globali

Sottocomandi

devin auth

devin mcp

devin rules

devin skills

devin list

devin version

devin acp

devin update

devin shell

devin sandbox

devin sandbox setup

devin setup

devin uninstall

Comandi slash

Modalità e modello

Gestione delle sessioni

Workspace

Automazione

Estensibilità

Utilità

Sessioni cloud (solo insiders)

Modalità

Profili