> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Commandes et options

> Référence complète des arguments de commande, des sous-commandes et des commandes slash interactives

<div id="usage">
  ## Utilisation
</div>

```bash theme={null}
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`.

***

<div id="global-flags">
  ## Options globales
</div>

| 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 :**

```bash theme={null}
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
```

***

<div id="subcommands">
  ## Sous-commandes
</div>

<div id="devin-auth">
  ### devin auth
</div>

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)

<div id="devin-mcp">
  ### devin mcp
</div>

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)
* `<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)

<Note>
  Les serveurs HTTP essaient d’abord Streamable HTTP, puis reviennent à l’ancien SSE en cas d’erreurs 4xx (conformément à la [spécification MCP](https://spec.modelcontextprotocol.io/specification/2025-03-26/basic/transports/#backwards-compatibility)). Vous pouvez aussi définir explicitement `"transport": "sse"`. Voir [Configuration MCP → Dépannage](/fr/cli/extensibility/mcp/configuration#troubleshooting).
</Note>

**Exemples :**

```bash theme={null}
# 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)

**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](/fr/cli/extensibility/mcp/configuration) pour plus de détails.

<div id="devin-rules">
  ### devin rules
</div>

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](/fr/cli/extensibility/rules) pour plus de détails.

<div id="devin-skills">
  ### devin skills
</div>

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](/fr/cli/extensibility/skills/overview) pour en savoir plus.

<div id="devin-list">
  ### devin list
</div>

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            |

<div id="devin-version">
  ### devin version
</div>

Affiche la version actuelle, puis quitte.

```bash theme={null}
devin version
```

Cela équivaut à `devin --version`.

<div id="devin-acp">
  ### devin acp
</div>

Exécutez Devin comme serveur [Agent Client Protocol (ACP)](https://agentclientprotocol.com/) 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.

```bash theme={null}
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`.

<div id="devin-update">
  ### devin update
</div>

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

```bash theme={null}
devin update
```

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

```bash theme={null}
devin update --force
```

<div id="devin-shell">
  ### devin shell
</div>

\[Aperçu de fonctionnalité] Commandes d’intégration au shell. Consultez [Intégration au shell](/fr/cli/shell-integration) 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`)                     |

<div id="devin-sandbox">
  ### devin sandbox
</div>

\[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é.

<div id="devin-sandbox-setup">
  #### devin sandbox setup
</div>

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](https://learn.microsoft.com/windows/wsl/install) et exécutez Devin dans votre distribution WSL.

```bash theme={null}
devin sandbox setup
```

<div id="devin-setup">
  ### devin setup
</div>

Assistant interactif de configuration pour l’authentification et MCP.

```bash theme={null}
devin setup
devin setup --force-manual-token-flow  # Pour les sessions distantes/SSH
```

<div id="devin-uninstall">
  ### devin uninstall
</div>

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                                                                    |

***

<div id="slash-commands">
  ## Commandes slash
</div>

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

<div id="mode-model">
  ### Mode et modèle
</div>

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

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

<div id="session-management">
  ### Gestion des sessions
</div>

| 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 `/`.                           |

<div id="workspace">
  ### Espace de travail
</div>

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

<div id="automation">
  ### Automatisation
</div>

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

<div id="extensibility">
  ### Extensibilité
</div>

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

<div id="utilities">
  ### Utilitaires
</div>

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

<div id="cloud-sessions-insiders-only">
  ### Sessions cloud (insiders uniquement)
</div>

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

***

<div id="modes">
  ## Modes
</div>

Les modes contrôlent le niveau d'autonomie de l'agent en combinant un mode d'autorisation et un profil d'agent.

<Tabs>
  <Tab title="Normal (par défaut)">
    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
  </Tab>

  <Tab title="Plan">
    Planification uniquement — l'agent propose des modifications sans les appliquer. L'accès aux outils en lecture seule garantit qu'aucun code n'est modifié.

    * **Mode d'autorisation :** Normal
    * **Profil :** Plan (outils en lecture seule)
    * **À utiliser pour :** conception de l'architecture, compréhension des bases de code, planification avant l'implémentation
  </Tab>

  <Tab title="Bypass">
    Toutes les demandes d'autorisation sont approuvées automatiquement. L'agent exécute librement sans demander de confirmation.

    * **Mode d'autorisation :** Dangerous
    * **Profil :** Normal
    * **À utiliser pour :** tâches de confiance pour lesquelles les interruptions vous ralentissent

    <Warning>
      Utilisez le mode Bypass uniquement pour des tâches auxquelles vous accordez une entière confiance. Tous les appels aux outils (y compris les commandes destructives) sont approuvés automatiquement.
    </Warning>
  </Tab>
</Tabs>

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.

***

<div id="profiles">
  ## Profils
</div>

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