Passer au contenu principal

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.

Démarrer le Devin CLI

Par défaut, les sessions se déroulent dans un REPL, une interface de terminal graphique où vous pouvez dialoguer et observer les actions de Devin.
devin                            # Démarrer le REPL interactif (sans prompt)
devin -- your prompt here        # Démarrer le REPL avec un prompt initial
devin -p "prompt"                # Tour unique, sans REPL : afficher la réponse sur stdout et quitter
devin -p -- prompt words here    # Identique, avec le séparateur -- (fonctionne aussi)
Utilisez -- avant votre prompt pour qu’il soit interprété comme un prompt, et non comme une sous-commande.
Le mode à tour unique (-p) est idéal pour les scripts et les automatisations.
Saisissez @ dans le champ de prompt pour ouvrir l’autocomplétion des fichiers/répertoires locaux. Le sélectionner l’ajoute au contexte de votre message.
Vous pouvez coller des images depuis votre presse-papiers avec Ctrl+V. Les images jointes apparaissent dans la zone de saisie, et vous pouvez les gérer avec Flèche gauche/droite pour naviguer et Retour arrière pour supprimer.

Exécution de commandes shell

Devin peut exécuter des commandes shell pendant qu’il travaille. Si une commande est toujours en cours d’exécution après le délai d’attente par défaut, Devin la bascule en arrière-plan et affiche la durée d’attente ainsi que l’identifiant du shell en arrière-plan. Devin peut ensuite continuer à travailler et consulter plus tard la sortie de la commande.

Modes

Devin CLI propose 4 modes d’autorisation intégrés : Normal, Accept Edits, Bypass et Autonomous, ainsi que 3 modes de l’agent : Normal, Plan et Ask. Pour plan et ask, utilisez /plan et /ask.

Normal

Approuve automatiquement les outils en lecture seule dans le répertoire actuel et demande une autorisation pour les opérations d’écriture ou d’exécution.
/normal
# or
/mode normal
Il s’agit du mode par défaut.
Approuve automatiquement les modifications de fichiers dans l’espace de travail, tout en continuant à demander une confirmation pour les commandes shell et les autres actions. C’est là que la plupart des utilisateurs passeront l’essentiel de leur temps.
/accept-edits
# or
/mode accept-edits
Approuve automatiquement tous les appels d’outil, y compris les écritures et les commandes shell.
/bypass
# or
/mode bypass
Vous pouvez aussi démarrer en mode bypass :
devin --permission-mode bypass
Alias : /yolo, /dangerous
Le mode Bypass ne remplace jamais les autorisations définies au niveau de l’organisation par votre administrateur via Team Settings. Les règles de refus et de demande imposées par l’administrateur ont toujours priorité.
À peu près équivalent à Accept Edits dans l’espace de travail actuel, avec en plus la possibilité d’exécuter n’importe quelle commande shell dans une sandbox au niveau de l’OS (pour limiter ce que ces commandes peuvent réellement affecter).
devin --sandbox --permission-mode autonomous
Autonomous est le seul mode d’autorisation disponible lors d’une exécution avec --sandbox, et il est sélectionné automatiquement — Normal, Accept Edits et Bypass sont masqués dans les sessions sandbox.En mode Autonomous…
  • Une confirmation vous est demandée pour les capacités plutôt que pour les commandes.
    • Les commandes respectent les périmètres Write et Read via une sandbox du système de fichiers.
    • Les commandes vous demandent une confirmation lorsqu’elles essaient d’accéder à des ressources réseau.
  • Les opérations en lecture seule dans le répertoire actuel sont automatiquement approuvées.
Autonomous s’appuie sur la sandbox pour la sécurité. Sans --sandbox, ce mode n’est pas disponible — utilisez Bypass si vous souhaitez une exécution sans supervision, sans isolation au niveau de l’OS. Consultez Bypass vs Autonomous ci-dessous pour une comparaison directe.

Bypass ou Autonomous

Bypass et Autonomous réduisent tous deux les demandes d’approbation, mais reposent sur des mécanismes de sécurité différents :
BypassAutonomous
Nécessite --sandboxNonOui (disponible uniquement dans les sessions sandbox)
Commandes shellApprouvées automatiquement, sans restrictionApprouvées automatiquement, isolées dans le sandbox
Écritures de fichiers via les outils edit/writeApprouvées automatiquement partoutNécessitent toujours une approbation (accorder un périmètre étend le sandbox)
Accès réseauSans restrictionFiltré par les listes d’autorisation/refus de domaines du sandbox
Respecte les Team Settings définis par l’adminOuiOui
Choisissez Bypass si vous faites confiance à l’agent sur l’ensemble de votre machine. Choisissez --sandbox (qui sélectionne Autonomous) si vous voulez une exécution sans supervision avec des limites imposées par l’OS sur les fichiers et les domaines auxquels l’agent peut accéder. Si vous aimez la simplicité de bypass mais voulez que l’agent ait son propre ordinateur, essayez cloud Devin !

Historique des sessions

L’historique de vos conversations est enregistré afin que vous puissiez reprendre une session plus tard.
devin -c              # Continuer la session la plus récente dans le répertoire courant
devin --continue

devin -r              # Choisir parmi les sessions récentes
devin --resume
devin -r brisk-otter  # Reprendre une session spécifique par ID

Commandes slash

Vous pouvez utiliser ces commandes pendant une session active.
CommandeDescription
/helpAfficher toutes les commandes disponibles
/exit ou /quitQuitter l’application
/clear ou /newEffacer l’historique de la conversation (repartir de zéro)
Vous pouvez aussi saisir exit ou quit en texte brut (sans le préfixe /) pour quitter.

Changement de mode

CommandeDescription
/modeAfficher le mode actuel
/mode <name>Changer de mode (normal, accept-edits, plan, bypass ; autonomous dans les sessions sandbox)
/normalPasser en mode Normal (par défaut)
/planPasser en mode Plan
/ask <question>Poser une question sans modifier le code (oneshot)
/bypassPasser en mode Bypass (alias : /yolo, /dangerous)

Sélection du modèle

CommandeDescription
/modelAfficher le sélecteur de modèle

Gestion des sessions

CommandeDescription
/resumeOuvrir le sélecteur interactif de sessions
/resume <id>Reprendre une session par son identifiant
/lsAfficher les sessions récentes du répertoire courant (alias : /list-sessions)
/ls --allAfficher toutes les sessions de tous les répertoires
/continueReprendre la session la plus récente
/continue <id>Reprendre une session par son identifiant
/rm-session <id>Supprimer irréversiblement une session par son identifiant

Espace de travail

CommandeDescription
/workspaceAfficher les répertoires d’espace de travail (alias : /workspaces)
/add-dir <path>Ajouter un répertoire d’espace de travail supplémentaire
/undo-add-dir <path>Supprimer un répertoire d’espace de travail

Automatisation

CommandeDescription
/loop <prompt>Exécute un prompt, puis lance une revue automatique du diff en boucle (nécessite un état Git propre au démarrage)

Extensibilité

CommandeDescription
/hooksAffiche tous les hooks chargés, avec leur ID, leur type d’événement et leur chemin source

Compte et système

CommandeDescription
/loginS’authentifier avec Devin
/logoutSupprimer les identifiants enregistrés et quitter
/updateVérifier et installer les mises à jour
/upgradePasser à une formule d’abonnement supérieure
/bugSignaler un bug aux développeurs du Devin CLI
/compactForcer la compression de la conversation
Si vous avez installé Devin for Terminal via Homebrew, /update vous invitera à utiliser brew upgrade devin au lieu d’exécuter une auto-mise à jour.

Raccourcis clavier

Voici les raccourcis clavier les plus importants. Consultez Raccourcis clavier pour découvrir d’autres raccourcis.
RaccourciDescription
Shift+TabPasser d’un mode à l’autre (Normal, Accept Edits, Plan, Bypass, Autonomous)
Ctrl+CEffacer le texte saisi ou annuler l’agent en cours d’exécution
EscAnnuler l’agent en cours d’exécution
Shift+EnterInsérer un saut de ligne (saisie sur plusieurs lignes)
Ctrl+V ou Shift+InsertColler depuis le presse-papiers
Ctrl+GOuvrir l’éditeur externe
Ctrl+OOuvrir la visionneuse en plein écran de la trace de réflexion
@Mentionner des fichiers à ajouter au contexte