Skip to main content

Utilisation

Fournissez un prompt facultatif pour démarrer une session avec un message initial, ou lancez la commande en mode interactif, sans argument. Vous pouvez aussi consulter ces informations depuis votre terminal avec 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.
Exemples :

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 8707 resource 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)
  • <URL> — Argument URL positionnel pour HTTP (alternative à --url)
  • -- <COMMAND> [ARGS...] — Commande et arguments pour stdio (le premier argument est la commande lorsque --command est omis)
Les serveurs HTTP essaient d’abord Streamable HTTP, puis reviennent à l’ancien SSE en cas d’erreurs 4xx (conformément à la spécification MCP). Vous pouvez aussi définir explicitement "transport": "sse". Voir Configuration MCP → Dépannage.
Exemples :
Options pour devin mcp remove :
  • -s, --scope <local|project|user> — Périmètre de configuration (par défaut : local)
Options pour devin mcp login :
  • --scopes <SCOPE,SCOPE> — Périmètres OAuth à demander (séparés par des virgules)
  • --oauth-resource <RESOURCE> — Remplace le paramètre resource de 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)
Options pour devin mcp enable :
  • -s, --scope <local|project|user> — Périmètre de configuration (par défaut : local)
Options pour devin mcp disable :
  • -s, --scope <local|project|user> — Périmètre de configuration (par défaut : local)
Consultez Configuration MCP pour plus de détails.

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
Voir Règles pour plus de détails.

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
Consultez Skills pour en savoir plus.

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
Consultez Plugins pour en savoir plus.

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)
La migration est une copie ponctuelle. La configuration que Devin CLI lit directement — règles, skills et serveurs MCP de Cursor, Windsurf, Claude Code, Copilot et autres — ne nécessite aucune migration ; consultez l’importation de configuration.

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 par devin 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)
Options de 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)
Options de 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
Consultez la référence Blueprint pour connaître le format environment.yaml lu et écrit par ces commandes.

devin version

Affiche la version actuelle, puis quitte.
Cela équivaut à 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.
Le serveur ACP lit les identifiants à partir de 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 :
  • /login et /logout sont 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.
Utilisez --force pour réinstaller même si vous avez déjà la dernière version :

devin shell

[Aperçu de fonctionnalité] Commandes d’intégration au shell. Consultez Intégration au shell pour plus de détails.

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) et socat. 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 en air gap et la connectivité aux endpoints des modèles.
devin doctor est uniquement disponible dans les builds en air gap de la CLI.

devin worker

Exécute l’interface CLI en tant que worker Outposts Outposts. Cette commande est masquée dans devin --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 cloud (insiders uniquement)


Modes

Les modes contrôlent le niveau d’autonomie de l’agent en combinant un mode d’autorisation et un profil d’agent.
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
Passez d’un mode à l’autre avec /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.

Profils

Les profils déterminent les outils auxquels l’agent a accès et son comportement. Les profils sont automatiquement définis lorsque vous changez de mode.