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.
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 | 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 |
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
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 |
devin auth login:
--force-manual-token-flow — Salta l’autenticazione tramite browser e incolla manualmente un token (utile per sessioni remote/SSH)
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 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)
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
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)
Per i dettagli, vedi Configurazione MCP.
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 |
devin rules list:
--provider <cursor\|windsurf> — Filtra per provider di regole
Per i dettagli, vedi Regole.
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 |
devin skills list:
--trigger <user\|model> — Filtra per tipo di trigger
Per maggiori dettagli, vedi Skills.
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.
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.
Verifica se sono disponibili aggiornamenti e, facoltativamente, installali.
Usa --force per reinstallare anche se hai già l’ultima versione installata:
[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 setup
devin setup --force-manual-token-flow # Per sessioni remote/SSH
| Opzione | Descrizione |
|---|
--clean | Rimuovi tutti i dati, inclusi configurazione, cronologia e dati personalizzati |
--force | Ignora la richiesta di conferma |
Questi comandi sono disponibili all’interno di una sessione interattiva. Digitateli nel prompt.
| Comando | Descrizione | | | |
|---|
| `/mode [normal | accept-edits | plan | bypass]` | Mostra o cambia la modalità corrente (autonomous è disponibile nelle sessioni sandbox) |
/normal | Passa alla modalità Normale (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.
| 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 /. |
| 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 |
| 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. |
| Comando | Descrizione |
|---|
/hooks | Elenca tutti gli hook caricati con i relativi ID, tipi di evento e percorsi sorgente |
| Comando | Descrizione |
|---|
/help | Mostra i comandi slash disponibili |
/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 |
/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. |
Debug (solo per gli Insider)
| Comando | Descrizione |
|---|
/debug-echo <json> | Scrive un payload JSON-RPC grezzo sul trasporto ACP (stdout). Utile per il testing del modo in cui i client ACP gestiscono messaggi specifici o condizioni di errore. Inserisce automaticamente "jsonrpc": "2.0" se manca. |
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
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
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
Usa la modalità Bypass solo per attività di cui ti fidi completamente. Tutte le chiamate agli strumenti, inclusi i comandi distruttivi, vengono approvate automaticamente.
/mode, oppure passa direttamente a /normal, /accept-edits, /plan o /bypass. Usa /ask <question> come comando oneshot per fare domande senza cambiare modalità.
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) |
