Skip to main content

Utilizzo

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

La modalità non interattiva --print non può mostrare il prompt relativo all’attendibilità del workspace, quindi non funziona in una directory non attendibile. Passa --respect-workspace-trust false per ignorare la verifica negli script e nella CI.
Esempi:

Sottocomandi

devin auth

Comandi relativi all’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. 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:
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 models

Elenca i modelli disponibili per il tuo account. Per maggiori dettagli, consulta Models.

devin rules

Gestisci le regole dell’agente (blocchi di contesto sempre attivi). 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). Opzioni per devin skills list:
  • --trigger <user\|model> — Filtra per tipo di trigger
Per maggiori dettagli, vedi Skills.

devin plugins

Gestisci i plugin, bundle che includono skills, regole, hook, server MCP e subagent. Una sorgente può essere un owner/repo GitHub, un URL git o un percorso locale. Aggiungi #path/to/plugin se il plugin si trova in una sottodirectory rispetto alla radice del repository. Opzioni:
  • -y, --yes (install) — Salta il prompt interattivo di attendibilità
  • --force (remove) — Rimuove il plugin anche se è ancora richiesto da un altro plugin o da una configurazione di governance
Per i dettagli, consulta Plugins.

devin migrate

Migra la configurazione da altri strumenti nei formati di Devin. Opzioni per devin migrate workflows:
  • --scope <all\|workspace\|global> — Flussi di lavoro da migrare (impostazione predefinita: all)
La migrazione è una copia una tantum. La configurazione che Devin CLI legge direttamente — regole, skill e server MCP di Cursor, Windsurf, Claude Code, Copilot e altri — non richiede migrazione; consulta Importazione della configurazione.

devin list

Elenca le sessioni nella directory corrente. Alias: devin ls

devin cloud

Gestisci le risorse di Devin Cloud dal terminale. I comandi usano le credenziali memorizzate da devin auth login: non è necessaria alcuna configurazione aggiuntiva dell’ambiente.

devin cloud drs

Gestisci Declarative Repo Setup: blueprint di ambiente, sessioni sandbox per testare la configurazione del repo e snapshot build. Opzioni per devin cloud drs sandbox-create:
  • --repo <owner/repo> — Repository a cui associare il sandbox (obbligatorio)
  • --prompt <PROMPT> — Prompt iniziale per la sessione sandbox
  • --secret <KEY=VALUE> — Segreto per sessione (ripetibile)
Opzioni per devin cloud drs run:
  • --devin-id <ID> — ID della sessione Devin (ad es. devin-abc123…) (obbligatorio)
  • --command <CMD> — Comando Shell da eseguire (obbligatorio)
  • --timeout <SECONDS> — Timeout lato server (predefinito: 600)
Opzioni per devin cloud drs blueprint-create:
  • --repo <owner/repo> — Repository a cui limitare l’ambito del blueprint; ometti per un blueprint per tutta l’org
  • --from-file <FILE> — File YAML con il contenuto iniziale del blueprint
Consulta il riferimento del blueprint per il formato environment.yaml letto e scritto da questi comandi.

devin version

Stampa la versione corrente ed esce.
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.
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. Opzioni:

Comando slash negli host ACP

Il server ACP espone tramite il protocollo l’intero set di comandi slash, che vengono quindi visualizzati nella command palette dell’host con descrizioni, suggerimenti sugli argomenti e categorie: Alcuni comandi dipendono dall’host e dal tuo account:
  • /login e /logout sono nascosti quando l’host gestisce direttamente l’autenticazione.
  • I comandi per le directory del workspace (/workspace, /add-dir, /remove-dir) vengono visualizzati solo quando l’host chiede all’agente di assumere il controllo delle radici del workspace. Gli host che gestiscono autonomamente le proprie radici non li visualizzano mai.

devin update

Verifica se sono disponibili aggiornamenti e, facoltativamente, installali.
Usa --force per reinstallare anche se hai già l’ultima versione installata:

devin shell

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

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 setup

Procedura guidata interattiva per configurare l’autenticazione e MCP.

devin doctor

Diagnostica la configurazione air-gapped e la connettività con l’endpoint del modello.
devin doctor è disponibile solo nelle build air-gapped della CLI.

devin worker

Esegue la CLI come worker di Outposts. Non è visualizzato in devin --help ed è documentato separatamente: consulta il riferimento di Outposts.

devin uninstall

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

Comandi slash

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

Modalità e modello

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

Gestione delle sessioni

Workspace

Automazione

Estensibilità

Utilità

Statistiche della sessione

/session-stats (alias /stats) offre una visualizzazione completa delle risorse consumate da una sessione, mentre /usage fornisce un breve riepilogo di crediti/ACU. Visualizza tutte le dimensioni di utilizzo riportate dal server — crediti, ACU, messaggi dell’Agent, continuazioni dei turni e utilizzo dei token — usando le etichette e i raggruppamenti del server, così le nuove dimensioni vengono mostrate senza richiedere un aggiornamento della CLI. La riga Model indica il modello che ha effettivamente gestito i turni fatturati, che può essere diverso dal modello selezionato. I totali persistono anche dopo la ripresa, quindi una sessione ripresa riporta il proprio utilizzo cumulativo anziché ripartire da zero.

Sessioni cloud (solo insiders)


Modalità

Le modalità controllano il livello di autonomia dell’agente combinando una modalità di autorizzazione con un profilo dell’agente.
Autonomia completa per attività di coding complesse. L’agente può leggere, scrivere ed eseguire comandi con i normali controlli di autorizzazione.
  • modalità di autorizzazione: Normal
  • profilo: 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, /smart, /plan, /bypass o /autonomous. 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à.