Commandes et options

Utilisation

devin [OPTIONS] [prompt]

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

Flag	Short	Description
`--model <MODEL>`		Définir le modèle d’IA pour cette session
`--permission-mode <MODE>`		Mode d’autorisation (`normal`, `dangerous`, `bypass`)
`--continue`	`-c`	Reprendre la session la plus récente dans le répertoire actuel
`--resume <SESSION_ID>`	`-r`	Reprendre une session spécifique à l’aide de son ID
`--print [PROMPT]`	`-p`	Afficher la réponse puis quitter (mode non interactif). Accepte éventuellement un prompt inline.
`--prompt-file <FILE>`		Charger le prompt initial depuis un fichier
`--config <PATH>`		Chemin du fichier de configuration
`--export [PATH]`		Exporter la conversation dans un fichier après chaque échange (format ATIF). Utilise un chemin par défaut si aucun n’est fourni.
`--respect-workspace-trust`		Indique s’il faut respecter les paramètres de confiance de l’espace de travail

Exemples :

devin -- add a login page
devin --model opus -- refactor the auth module
devin -c                              # Reprendre la dernière session
devin -r abc12345                     # Reprendre une session spécifique
devin -p "list all TODO comments"    # Afficher la réponse et quitter
devin -p -- list all TODO comments    # Identique, avec le séparateur -- (fonctionne aussi)
devin --export -- fix the tests       # Exporter la conversation vers le chemin par défaut
devin --export out.json -- fix tests   # Exporter vers un fichier spécifique

Sous-commandes

devin auth

Commandes d’authentification.

Commande	Description
`devin auth login`	Se connecter à votre compte
`devin auth logout`	Se déconnecter et supprimer les identifiants enregistrés
`devin auth status`	Vérifier l’état de l’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.

Commande	Description
`devin mcp add <name>`	Ajouter un nouveau serveur MCP
`devin mcp list`	Afficher la liste de tous les serveurs MCP configurés
`devin mcp get <name>`	Afficher les détails d’un serveur MCP spécifique
`devin mcp remove <name>`	Supprimer un serveur MCP configuré
`devin mcp login <name>`	S’authentifier auprès d’un serveur MCP via OAuth
`devin mcp logout <name>`	Supprimer les identifiants OAuth enregistrés pour un serveur MCP
`devin mcp enable <name>`	Activer un serveur MCP désactivé
`devin mcp disable <name>`	Désactiver un serveur MCP sans le supprimer

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 :

# serveur stdio
devin mcp add my-server -- npx @company/mcp-server --port 3000

# serveur HTTP (URL positionnelle)
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

# serveur HTTP (option --url, fonctionne également)
devin mcp add notion --url https://mcp.notion.com/mcp

# Avec des variables d'environnement et un périmètre
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

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 rules

Gérer les règles de l’agent (blocs de contexte toujours actifs).

Commande	Description
`devin rules list`	Lister toutes les règles disponibles
`devin rules show <name>`	Afficher les détails d’une règle spécifique
`devin rules paths`	Afficher l’emplacement des répertoires de règles

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).

Command	Description
`devin skills list`	Lister toutes les skills disponibles
`devin skills show <name>`	Afficher les détails d’une skill spécifique
`devin skills paths`	Afficher l’emplacement des répertoires de skills

Options pour devin skills list :

--trigger <user\|model> — Filtrer par type de déclencheur

Consultez Skills pour en savoir plus.

devin list

Liste les sessions dans le répertoire courant. Alias : devin ls

Commande	Description
`devin list`	Sélecteur interactif de sessions (par défaut)
`devin list --format json`	Affiche les sessions au format JSON
`devin list --format csv`	Affiche les sessions au format CSV

devin version

Affiche la version actuelle, puis quitte.

devin version

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.

devin acp

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.

devin update

Vérifiez les mises à jour et installez-les si vous le souhaitez.

devin update

Utilisez --force pour réinstaller même si vous avez déjà la dernière version :

devin update --force

devin shell

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

Commande	Description
`devin shell setup`	Installer l’intégration au shell dans le fichier de configuration de votre shell
`devin shell setup <shell>`	Installer pour un shell spécifique (`bash`, `zsh` ou `fish`)

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 sandbox setup

devin setup

Assistant interactif de configuration pour l’authentification et MCP.

devin setup
devin setup --force-manual-token-flow  # Pour les sessions distantes/SSH

devin uninstall

Désinstalle Devin CLI et supprime, si besoin, toutes les données.

Option	Description
`--clean`	Supprime toutes les données, y compris la configuration, l’historique et les données personnalisées
`--force`	Ignore le prompt de confirmation

Commandes slash

Ces commandes sont disponibles dans une session interactive. Tapez-les dans le prompt.

Mode et modèle

Commande	Description
`/mode [normal	accept-edits	plan	bypass]`	Affiche ou change le mode actuel (`autonomous` est disponible dans les sessions sandbox)
`/normal`	Passe en mode Normal (par défaut)
`/accept-edits`	Passe en mode Accept Edits (approuve automatiquement les modifications de fichiers dans l’espace de travail)
`/plan`	Passe en mode Plan (planification en lecture seule)
`/ask <question>`	Pose une question sans apporter de modifications au code (oneshot)
`/bypass`	Passe en mode Bypass (approuve automatiquement toutes les actions)
`/model [name]`	Affiche ou change le modèle actuel
`/fast`	Passe à SWE-1.6 Fast
`/theme [dark\|light\|terminal-dark\|terminal-light\|no-color]`	Bascule entre les thèmes (sombre, clair, terminal sombre, terminal clair, sans couleur)

/bypass a pour alias /yolo et /dangerous. Les trois ont le même effet.

Gestion des sessions

Commande	Description
`/clear`	Effacer l’historique de la conversation et démarrer une nouvelle session. Alias : `/new`
`/continue [session-id]`	Reprendre une session précédente
`/fork [step]`	Créer une nouvelle session à partir de la session actuelle. Vous pouvez éventuellement partir d’une étape spécifique (voir `/steps`).
`/steps`	Afficher les étapes de la conversation (à utiliser avec `/fork` et `/revert`)
`/revert <step>`	Annuler les modifications de fichiers à partir d’une étape spécifique et ramener la conversation à l’état antérieur à cette étape
`/resume [session-id]`	Ouvrir le sélecteur interactif de sessions, ou reprendre une session spécifique via son ID
`/ls [--all]`	Afficher les sessions récentes (répertoire actuel uniquement par défaut). Alias : `/list-sessions`
`/rename-session <new title>`	Renommer la session actuelle
`/rm-session <session-id>`	Supprimer définitivement une session et toutes ses données
`/export`	Afficher les informations d’export. Utilisez l’option CLI `--export` pour activer l’export de la conversation.
`/exit`	Quitter l’application (alias : `/quit`). Vous pouvez également saisir `exit` ou `quit` sans le préfixe `/`.

Espace de travail

Commande	Description
`/workspace`	Afficher la liste des 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

Commande	Description
`/loop <prompt>`	Exécute un prompt, puis lance une revue automatique du diff en boucle
`/btw <prompt>`	Pose une question rapide en aparté. Exécute une sidechain à partir du contexte de la conversation en cours et affiche la réponse dans un encadré, sans ajouter la question à la conversation principale.

Extensibilité

Commande	Description
`/hooks`	Répertorie tous les hooks chargés avec leurs ID, types d’événement et chemins d’accès source

Utilitaires

Commande	Description
`/help`	Afficher les commandes slash disponibles
`/shortcuts`	Parcourir les raccourcis clavier dans une liste interactive, consultable par recherche et groupée par catégorie
`/bug [description]`	Signaler un bug aux développeurs de la CLI Devin
`/update [--force]`	Vérifier et installer les mises à jour. Passez `--force` pour réinstaller même si vous disposez déjà de la dernière version.
`/upgrade`	Mettre à niveau votre formule d’abonnement
`/login`	Vous connecter à votre compte
`/logout`	Effacer les identifiants enregistrés et quitter
`/context`	Afficher l’utilisation de la fenêtre de contexte
`/usage`	Afficher l’utilisation estimée des crédits/ACU pour la session, y compris celle des ouvertures précédentes d’une session reprise
`/compact`	Forcer la compaction de la conversation

Sessions cloud (insiders uniquement)

Commande	Description
`/cloud-sessions [--all]`	Ouvre un sélecteur interactif de vos sessions récentes sur cloud Devin. Utilisez les touches fléchées pour naviguer, saisissez du texte pour filtrer, appuyez sur Entrée pour vous connecter, sur Échap pour annuler. Passez `--all` pour afficher les sessions à l’échelle de l’organisation.
`/cloud-attach <session-id>`	Connecte à une session cloud Devin avec un rendu TUI complet et une saisie bidirectionnelle.

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
Bypass

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, /plan ou /bypass. 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.

Profil	Description	Accès aux outils
`normal`	Assistant de programmation complet (utilisé par les modes Normal, Accept Edits et Bypass)	Tous les outils
`plan`	workflow de planification structuré (utilisé par le mode Plan)	Outils en lecture seule (grep, glob, read, todo, ask_user_question, exit_plan_mode)
`ask`	Réponse aux questions (utilisé par la commande `/ask`)	Outils en lecture seule (grep, glob, read, todo, ask_user_question)

​Utilisation

​Options globales

​Sous-commandes

​devin auth

​devin mcp

​devin rules

​devin skills

​devin list

​devin version

​devin acp

​devin update

​devin shell

​devin sandbox

​devin sandbox setup

​devin setup

​devin uninstall

​Commandes slash

​Mode et modèle

​Gestion des sessions

​Espace de travail

​Automatisation

​Extensibilité

​Utilitaires

​Sessions cloud (insiders uniquement)

​Modes

​Profils

Utilisation

Options globales

Sous-commandes

devin auth

devin mcp

devin rules

devin skills

devin list

devin version

devin acp

devin update

devin shell

devin sandbox

devin sandbox setup

devin setup

devin uninstall

Commandes slash

Mode et modèle

Gestion des sessions

Espace de travail

Automatisation

Extensibilité

Utilitaires

Sessions cloud (insiders uniquement)

Modes

Profils