Vai al contenuto principale

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.

Avvio della CLI di Devin

Per impostazione predefinita, le sessioni si svolgono in una REPL, un’interfaccia terminale grafica in cui puoi interagire in chat e osservare le azioni di Devin.
devin                            # Avvia REPL interattivo (senza prompt)
devin -- your prompt here        # Avvia REPL con prompt iniziale
devin -p "prompt"                # Turno singolo, senza REPL: stampa la risposta su stdout ed esce
devin -p -- prompt words here    # Come sopra, con il separatore -- (funziona ugualmente)
Usa -- prima del prompt, così verrà interpretato come prompt e non come sottocomando.
La modalità a singolo turno (-p) è ideale per script e automazioni.
Digita @ nel campo di input del prompt per aprire il completamento automatico di file/directory locali. Selezionandone uno, verrà aggiunto come contesto al tuo messaggio.
Puoi incollare immagini dagli appunti con Ctrl+V. Le immagini allegate compaiono nell’area di input e puoi gestirle con Freccia sinistra/destra per spostarti e Backspace per rimuoverle.

Esecuzione dei comandi shell

Devin può eseguire comandi shell durante il lavoro. Se un comando è ancora in esecuzione allo scadere del periodo di attesa predefinito, Devin lo sposta in background e mostra per quanto tempo ha atteso, insieme all’ID della shell in background. Devin può quindi continuare a lavorare e verificare l’output del comando in un secondo momento.

Modalità

Devin CLI ha 4 modalità di autorizzazione integrate: Normal, Accept Edits, Bypass e Autonomous, e 3 modalità dell’agente: Normal, Plan e Ask. Per plan e ask, usa /plan e /ask.

Normal

Approva automaticamente i tool di sola lettura nella directory corrente e richiede l’autorizzazione per le operazioni di scrittura o esecuzione.
/normal
# oppure
/mode normal
Questa è la modalità predefinita.
Approva automaticamente le modifiche ai file nel workspace, continuando però a chiedere conferma per i comandi shell e le altre azioni. È qui che prevediamo che gli utenti passeranno la maggior parte del tempo.
/accept-edits
# oppure
/mode accept-edits
Approva automaticamente tutte le chiamate ai tool, incluse le scritture e i comandi shell.
/bypass
# oppure
/mode bypass
Puoi anche avviare direttamente la modalità bypass:
devin --permission-mode bypass
Alias: /yolo, /dangerous
La modalità Bypass non prevale mai sulle autorizzazioni a livello di organizzazione configurate dal tuo admin tramite Team Settings. Le regole di blocco e richiesta di conferma applicate dall’admin hanno sempre la priorità.
È grossomodo equivalente ad Accept Edits nel workspace corrente, con in più la possibilità di eseguire qualsiasi comando shell all’interno di una sandbox a livello di sistema operativo (per limitare ciò che questi comandi possono effettivamente toccare).
devin --sandbox --permission-mode autonomous
Autonomous è l’unica modalità di autorizzazione disponibile quando si esegue con --sandbox e viene selezionata automaticamente: Normal, Accept Edits e Bypass non sono mostrate nelle sessioni sandbox.In modalità Autonomous…
  • Ti viene chiesta l’autorizzazione per le capacità anziché per i comandi.
    • I comandi rispettano gli ambiti Write e Read tramite una sandbox del filesystem.
    • I comandi ti chiedono conferma quando tentano di connettersi a risorse di rete.
  • Le operazioni di sola lettura nella directory corrente vengono approvate automaticamente.
Autonomous si basa sulla sandbox per la sicurezza. Senza --sandbox, la modalità non è disponibile: usa Bypass se vuoi un’esecuzione non presidiata senza isolamento a livello di sistema operativo. Per un confronto diretto, vedi Bypass vs Autonomous qui sotto.

Bypass vs Autonomous

Bypass e Autonomous riducono entrambi le richieste di approvazione, ma si basano su meccanismi di sicurezza diversi:
BypassAutonomous
Richiede --sandboxNoSì (disponibile solo nelle sessioni sandbox)
Comandi shellApprovati automaticamente, senza restrizioniApprovati automaticamente, isolati nella sandbox
Scritture su file tramite gli strumenti edit/writeApprovate automaticamente ovunqueRichiedono ancora conferma (concedere un ambito amplia la sandbox)
Accesso alla reteSenza restrizioniFiltrato dagli elenchi di autorizzazione/blocco dei domini della sandbox
Rispetta i Team Settings dell’admin
Scegli Bypass quando ritieni attendibile l’agente sull’intera macchina. Scegli --sandbox (che seleziona Autonomous) quando vuoi un’esecuzione non presidiata con limiti imposti dal sistema operativo su file e domini a cui l’agente può accedere. Se ti piace l’esperienza di Bypass ma vuoi che l’agente abbia un computer tutto suo, prova cloud Devin!

Cronologia della sessione

La cronologia della conversazione viene salvata così da poter riprendere la sessione in un secondo momento.
devin -c              # Continua la sessione più recente nella directory corrente
devin --continue

devin -r              # Seleziona tra le sessioni recenti
devin --resume
devin -r brisk-otter  # Riprendi una sessione specifica tramite ID

Comandi slash

Puoi usare questi comandi durante una sessione attiva.
ComandoDescrizione
/helpVisualizza tutti i comandi disponibili
/exit or /quitEsce dall’applicazione
/clear or /newCancella la cronologia della conversazione (ricomincia da capo)
Puoi anche digitare exit o quit come testo normale (senza il prefisso /) per uscire.

Cambio modalità

ComandoDescrizione
/modeMostra la modalità attuale
/mode <name>Cambia modalità (normal, accept-edits, plan, bypass; autonomous nelle sessioni sandbox)
/normalPassa alla modalità Normal (predefinita)
/planPassa alla modalità Plan
/ask <question>Poni una domanda senza apportare modifiche al codice (oneshot)
/bypassPassa alla modalità Bypass (alias: /yolo, /dangerous)

Cambio modello

ComandoDescrizione
/modelMostra il selettore del modello

Gestione delle sessioni

ComandoDescrizione
/resumeApre il selettore interattivo delle sessioni
/resume <id>Riprende la sessione tramite ID
/lsElenca le sessioni recenti nella directory corrente (alias: /list-sessions)
/ls --allElenca tutte le sessioni in tutte le directory
/continueRiprende la sessione più recente
/continue <id>Riprende la sessione tramite ID
/rm-session <id>Elimina definitivamente una sessione tramite ID

Workspace

ComandoDescrizione
/workspaceElenca le directory del workspace (alias: /workspaces)
/add-dir <path>Aggiungi una directory aggiuntiva al workspace
/undo-add-dir <path>Rimuovi una directory dal workspace

Automazione

ComandoDescrizione
/loop <prompt>Esegui un prompt, quindi avvia la revisione automatica del diff in un ciclo (richiede uno stato Git pulito all’avvio)

Estensibilità

ComandoDescrizione
/hooksElenca tutti gli hook caricati con i relativi ID, tipi di evento e percorsi sorgente

Account e sistema

ComandoDescrizione
/loginEffettuare l’accesso con Devin
/logoutEliminare le credenziali salvate e uscire
/updateVerificare e installare gli aggiornamenti disponibili
/upgradePassare a un piano di abbonamento superiore
/bugSegnalare un bug agli sviluppatori della CLI di Devin
/compactForzare la compattazione della conversazione
Se hai installato Devin for Terminal tramite Homebrew, /update ti inviterà a usare brew upgrade devin invece di eseguire un autoaggiornamento.

Scorciatoie da tastiera

Ecco le scorciatoie da tastiera più importanti. Consulta Keyboard Shortcuts per vedere altre scorciatoie.
ScorciatoiaDescrizione
Shift+TabScorre ciclicamente tra le modalità (Normal, Accept Edits, Plan, Bypass, Autonomous)
Ctrl+CCancella il testo immesso oppure interrompe l’agente in esecuzione
EscInterrompe l’agente in esecuzione
Shift+EnterInserisce una nuova riga (input su più righe)
Ctrl+V o Shift+InsertIncolla dagli appunti
Ctrl+GApre l’editor esterno
Ctrl+OApre il visualizzatore a schermo intero della traccia di ragionamento
@Menziona i file da aggiungere al contesto