Utilisation
man devin.
Options globales
Le mode non interactif
--print ne peut pas afficher l’invite de confiance de l’espace de travail ; il échoue donc dans un répertoire non approuvé. Utilisez --respect-workspace-trust false pour ignorer cette vérification dans les scripts et l’intégration continue.Sous-commandes
devin auth
Commandes d’authentification.
Options pour
devin auth login :
--force-manual-token-flow— Ignorer l’authentification via le navigateur et coller manuellement un token (utile pour les sessions SSH distantes)
devin mcp
Connectez-vous aux serveurs Model Context Protocol et authentifiez-vous.
Options pour
devin mcp add :
-t, --transport <stdio|http>— Type de transport (facultatif ; déduit de l’URL → http, des arguments finaux → stdio)-s, --scope <local|project|user>— Périmètre de configuration (par défaut :local)--url <URL>— URL du transport HTTP (peut aussi être passée comme argument positionnel après le nom)--command <CMD>— Commande pour le transport stdio (facultatif lorsque des arguments finaux sont fournis)-e, --env <KEY=VALUE>— Variables d’environnement (répétable)-H, --header <HEADER: VALUE>— En-têtes HTTP (répétable)--scopes <SCOPE,SCOPE>— Périmètres OAuth à demander (séparés par des virgules)--oauth-resource <RESOURCE>— Remplacer le paramètre RFC 8707resourceenvoyé dans les requêtes OAuth (par défaut : l’URL du serveur MCP ; passez une chaîne vide pour l’omettre avec les fournisseurs qui le refusent)<URL>— Argument URL positionnel pour HTTP (alternative à--url)-- <COMMAND> [ARGS...]— Commande et arguments pour stdio (le premier argument est la commande lorsque--commandest omis)
Les serveurs HTTP essaient d’abord Streamable HTTP, puis reviennent à l’ancien SSE en cas d’erreurs 4xx non liées à l’authentification, comme 404 ou 405 (conformément à la spécification MCP). Les réponses 401, ainsi que les réponses 403 pour périmètre insuffisant, accompagnées d’un défi
WWW-Authenticate sont remontées directement afin que vous puissiez vous authentifier. Vous pouvez aussi définir explicitement "transport": "sse". Voir Configuration MCP → Dépannage.devin mcp remove :
-s, --scope <local|project|user>— Périmètre de configuration (par défaut :local)
devin mcp login :
--scopes <SCOPE,SCOPE>— Périmètres OAuth à demander (séparés par des virgules)--oauth-resource <RESOURCE>— Remplace le paramètreresourcede la RFC 8707 envoyé dans les requêtes OAuth (par défaut : l’URL du serveur MCP ; passez une chaîne vide pour l’omettre avec les fournisseurs qui le refusent)
devin mcp enable :
-s, --scope <local|project|user>— Périmètre de configuration (par défaut :local)
devin mcp disable :
-s, --scope <local|project|user>— Périmètre de configuration (par défaut :local)
devin models
Répertorie les modèles disponibles pour votre compte.
Consultez Models pour plus de détails.
devin rules
Gérer les règles de l’agent (blocs de contexte toujours actifs).
Options pour
devin rules list :
--provider <cursor\|windsurf>— Filtrer par fournisseur de règles
devin skills
Gérez les skills de l’agent (slash commands et blocs de contexte déclenchés par l’agent).
Options pour
devin skills list :
--trigger <user\|model>— Filtrer par type de déclencheur
devin plugins
Gérez les plugins — des bundles qui regroupent des skills, des règles, des hooks, des serveurs MCP et des subagents.
Une source peut être un
owner/repo GitHub, une URL Git ou un chemin local. Ajoutez #path/to/plugin lorsque le plugin se trouve dans un sous-répertoire d’un repository.
Options :
-y, --yes(install) — Ignore le prompt interactif de confiance--force(remove) — Supprime même si un autre plugin ou une configuration de gouvernance l’exige encore
devin migrate
Migrez la configuration d’autres outils vers les formats propres à Devin.
Options de
devin migrate workflows :
--scope <all\|workspace\|global>— Workflows à migrer (par défaut :all)
devin list
Liste les sessions dans le répertoire courant. Alias :devin ls
devin cloud
Gérez les ressources Devin Cloud depuis le terminal. Les commandes utilisent les identifiants stockés pardevin auth login — aucune configuration supplémentaire de l’environnement n’est nécessaire.
devin cloud drs
Gérez les Declarative Repo Setup : blueprints d’environnement, sessions sandbox pour tester la configuration des repositories et builds de snapshots.
Options de
devin cloud drs sandbox-create :
--repo <owner/repo>— Repository auquel associer le sandbox (obligatoire)--prompt <PROMPT>— Prompt initial de la session sandbox--secret <KEY=VALUE>— Secret propre à la session (répétable)
devin cloud drs run :
--devin-id <ID>— ID de session Devin (p. ex.devin-abc123…) (obligatoire)--command <CMD>— Commande shell à exécuter (obligatoire)--timeout <SECONDS>— Délai d’expiration côté serveur (par défaut :600)
devin cloud drs blueprint-create :
--repo <owner/repo>— Repository auquel limiter le blueprint ; omettez cette option pour un blueprint à l’échelle de l’organisation--from-file <FILE>— Fichier YAML contenant le contenu initial du blueprint
environment.yaml lu et écrit par ces commandes.
devin version
Affiche la version actuelle, puis quitte.devin --version.
devin acp
Exécutez Devin comme serveur Agent Client Protocol (ACP) via stdio. Cette sous-commande est destinée à être invoquée comme sous-processus par un éditeur ou un IDE compatible ACP (comme Windsurf ou Zed) — elle communique en JSON-RPC via stdin/stdout et n’est pas destinée à être utilisée de manière interactive.WINDSURF_API_KEY si cette variable est définie ; sinon, il utilise les identifiants stockés par devin auth login. Il peut également accepter des identifiants au moment de l’exécution via la requête ACP authenticate.
Options :
Commandes slash dans les hôtes ACP
Le serveur ACP expose l’ensemble de ses commandes slash via le protocole. Elles apparaissent donc dans la palette de commandes de l’hôte, avec leurs descriptions, des indications sur les arguments et des catégories :
Certaines commandes dépendent de l’hôte et de votre compte :
/loginet/logoutsont masquées lorsque l’hôte gère lui-même l’authentification.- Les commandes liées aux répertoires d’espace de travail (
/workspace,/add-dir,/remove-dir) n’apparaissent que lorsque l’hôte demande à l’agent de gérer les répertoires racines des espaces de travail. Les hôtes qui gèrent leurs propres répertoires racines ne les affichent jamais.
devin update
Vérifiez les mises à jour et installez-les si vous le souhaitez.--force pour réinstaller même si vous avez déjà la dernière version :
devin sandbox
[Aperçu de recherche] Gérez l’isolation en sandbox des processus au niveau du système d’exploitation pour l’outil exec. Passez l’option globale--sandbox pour lancer une session avec le sandbox activé.
devin sandbox setup
Affiche les prérequis du sandbox pour la plateforme actuelle. Prérequis pour une exécution avec--sandbox :
- Linux : nécessite bubblewrap (
bwrap) etsocat. Une session sandbox ne parvient pas à démarrer et affiche des instructions d’installation si l’un des deux manque — y compris dans une distribution WSL fraîchement installée. - macOS : fonctionne immédiatement grâce à Seatbelt ; aucun package supplémentaire n’est requis.
- Windows : le sandbox ne peut pas être exécuté nativement sous Windows. Installez WSL 2 et exécutez Devin dans votre distribution WSL.
devin setup
Assistant interactif de configuration pour l’authentification et MCP.devin doctor
Diagnostique la configuration locale de Devin. La commande indique quels profils de sous-agents personnalisés ont été chargés, signale toute définitionAGENT.md dont le frontmatter n’a pas pu être analysé (ces définitions sont ignorées à l’exécution) et émet un avertissement pour les clés de frontmatter que Devin ignore. La commande renvoie un code de sortie non nul si une vérification échoue.
devin airgap doctor
Diagnostique la configuration en air gap et la connectivité aux endpoints de modèles. Outre la vérification des sous-agents personnalisés effectuée pardevin doctor, cette commande contrôle la licence, les chemins de configuration locaux et le fichier des modèles, puis teste chaque endpoint de modèle configuré.
devin airgap doctor n’est disponible que dans les builds en air gap de la CLI.devin ssh
Se connecter en SSH à la VM d’une session Devin dans le cloud. Encapsule la commandessh du système vers le gateway SSH de Devin et approuve la connexion à l’aide des credentials de votre compte connecté, ce qui évite tout aller-retour par le navigateur. Voir SSH.
devin forward
Redirige les ports de la VM d’une session Devin dans le cloud vers localhost, afin qu’un serveur de développement tournant sur la machine soit accessible à l’adressehttp://localhost:<port>. S’exécute jusqu’à l’interruption par Ctrl-C.
<port> ou <local>:<port> :
devin worker
Exécute l’interface CLI en tant que worker Outposts Outposts. Cette commande est masquée dansdevin --help et documentée séparément : consultez la référence Outposts.
devin uninstall
Désinstalle Devin CLI et supprime, si besoin, toutes les données.Commandes slash
Ces commandes sont disponibles dans une session interactive. Tapez-les dans le prompt.Mode et modèle
/bypass a pour alias /yolo et /dangerous. Les trois ont le même effet.Gestion des sessions
Espace de travail
Automatisation
Extensibilité
Utilitaires
Statistiques de la session
/session-stats (alias /stats) offre une vue complète de la consommation d’une session, tandis que /usage fournit un résumé des crédits et des ACU. Cette commande affiche toutes les dimensions d’utilisation signalées par le serveur — crédits, ACU, messages de l’agent, continuations de tour et utilisation des tokens — en reprenant les libellés et regroupements du serveur, de sorte que les nouvelles dimensions apparaissent sans nécessiter de mise à jour de la CLI. La ligne Model indique le modèle qui a réellement exécuté les tours facturés, lequel peut différer du modèle que vous avez sélectionné. Les totaux sont conservés après la reprise, de sorte qu’une session reprise indique son utilisation cumulée au lieu de repartir de zéro.
Sessions Devin dans le cloud
Consultez Cloud CLI pour un guide sur l’exécution de sessions Devin Cloud depuis le terminal.Modes
Les modes contrôlent le niveau d’autonomie de l’agent en combinant un mode d’autorisation et un profil d’agent.- Normal (par défaut)
- Plan
- Smart
- Bypass
- Autonomous
Autonomie complète pour les tâches de codage complexes. L’agent peut lire, écrire et exécuter des commandes avec les contrôles d’autorisation normaux.
- Mode d’autorisation : Normal
- Profil : Normal
- À utiliser pour : refactorisation sur plusieurs fichiers, implémentation de fonctionnalités, correctifs de bugs
/mode, ou basculez directement avec /normal, /accept-edits, /smart, /plan, /bypass ou /autonomous. Utilisez /ask <question> comme commande ponctuelle pour poser des questions sans changer de mode.

