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

> Référence complète de la CLI Devin : flags globaux, sous-commandes telles que devin auth, mcp, ssh et forward, et commandes slash interactives.

## Utilisation

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

***

## Options globales

| Indicateur | Court | Variable d'environnement | Description |
| - | - | - | - |
| `--model <MODEL>` | | `DEVIN_MODEL` | Définit le modèle d’IA pour cette session |
| `--permission-mode <MODE>` | | `DEVIN_PERMISSION_MODE` | Mode d’autorisation : `normal` (alias `auto`, valeur par défaut), `accept-edits`, `smart`, `dangerous` (alias `yolo`, `bypass`) ou `autonomous` (nécessite `--sandbox`). Consultez [Permissions](https://docs.devin.ai/fr/cli/reference/permissions.md). |
| `--sandbox` | | `DEVIN_SANDBOX` | \[Aperçu de la recherche] Processus de l’outil d’exécution dans le sandbox (macOS seatbelt / Linux bwrap+seccomp). Consultez [Sandbox](https://docs.devin.ai/fr/cli/sandbox.md). |
| `--cloud` | | | Pilote les [sessions Devin dans le cloud](https://docs.devin.ai/fr/cli/cloud.md) au lieu du Local Agent. Nécessite un compte Devin. |
| `--continue` | `-c` | | Reprend la session la plus récente dans le répertoire courant |
| `--resume <SESSION_ID>` | `-r` | | Reprend une session spécifique à l’aide de son ID. Avec `--cloud`, accepte un ID ou une URL de session Devin dans le cloud. |
| `--print [PROMPT]` | `-p` | | Affiche la réponse et quitte (mode non interactif). Accepte éventuellement un prompt en ligne. |
| `--prompt-file <FILE>` | | | Charge le prompt initial à partir d’un fichier |
| `--config <PATH>` | | | Chemin du fichier de configuration |
| `--export [PATH]` | | | Exporte la conversation dans un fichier après chaque tour (format ATIF). Utilise un chemin par défaut si aucun n’est fourni. |
| `--respect-workspace-trust [true\|false]` | | | Indique s’il faut respecter les paramètres de confiance de l’espace de travail. La valeur par défaut est `true`. |

> [!NOTE]
>
> 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 :**

```bash theme={null}
devin -- add a login page
devin --model opus -- refactor the auth module
devin --permission-mode accept-edits -- fix the failing tests
devin --sandbox -- run the migration script
devin -c                                           # Reprend la dernière session
devin -r abc12345                                  # Reprend une session spécifique
devin --cloud                                      # Démarre une session Devin dans le cloud
devin --cloud -r https://app.devin.ai/sessions/…   # Reprend une session Devin dans le cloud
devin -p "list all TODO comments"                  # Affiche la réponse et quitte
devin -p -- list all TODO comments                 # Identique, avec le séparateur -- (toujours pris en charge)
devin --export -- fix the tests                    # Exporte la conversation vers le chemin par défaut
devin --export out.json -- fix tests               # Exporte 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 credentials 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)

> [!NOTE]
>
> 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](https://spec.modelcontextprotocol.io/specification/2025-03-26/basic/transports/#backwards-compatibility)). 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](https://docs.devin.ai/fr/cli/extensibility/mcp/configuration.md#troubleshooting).

**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/v1/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](https://docs.devin.ai/fr/cli/extensibility/mcp/configuration.md) pour plus de détails.

### devin models

Répertorie les modèles disponibles pour votre compte.

| Commande | Description |
| - | - |
| `devin models list` | Répertorie les modèles disponibles, organisés par famille de modèles |
| `devin models list --format json` | Affiche la liste des modèles au format JSON (pour les scripts) |

Consultez [Models](https://docs.devin.ai/fr/cli/models.md) 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](https://docs.devin.ai/fr/cli/extensibility/rules.md) 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](https://docs.devin.ai/fr/cli/extensibility/skills/overview.md) 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.

| Command | Description |
| - | - |
| `devin plugins install <source>` | Installe un plugin et les plugins dont il dépend |
| `devin plugins list` | Liste les plugins installés avec leur version et leur statut de blocage |
| `devin plugins info <name>` | Affiche les skills, hooks et règles d’un plugin, ainsi que ses listes de plugins requis, facultatifs et interdits |
| `devin plugins update [name]` | Récupère et réinstalle un plugin à partir du HEAD le plus récent. Omettez le nom pour mettre à jour tous les plugins. |
| `devin plugins remove <name>` | Supprime un plugin installé |
| `devin plugins prune` | Supprime les dépendances des repos qui n’existent plus sur le disque, puis nettoie le contenu des plugins non référencé |

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

```bash theme={null}
devin plugins install acme/review-tools
devin plugins install acme/vendor-plugins#plugins/stripe
devin plugins info review-tools
```

Consultez [Plugins](https://docs.devin.ai/fr/cli/extensibility/plugins/overview.md) pour en savoir plus.

### devin migrate

Migrez la configuration d'autres outils vers les formats propres à Devin.

| Commande | Description |
| - | - |
| `devin migrate hooks` | Migrez les hooks Windsurf (`.windsurf/hooks.json`) vers les hooks Devin (`.devin/hooks.v1.json`) |
| `devin migrate workflows` | Migrez les fichiers de workflow en skills et supprimez les fichiers d'origine |

**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](https://docs.devin.ai/fr/cli/reference/configuration/read-config-from.md).

### 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 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](https://docs.devin.ai/fr/onboard-devin/environment/blueprints.md) : blueprints d’environnement, sessions sandbox pour tester la configuration des repositories et builds de snapshots.

| Command | Description |
| - | - |
| `devin cloud drs whoami` | Affiche la configuration actuelle (organisation, endpoint d’API, état d’authentification) |
| `devin cloud drs sandbox-create --repo <owner/repo>` | Crée une session sandbox Devin associée à un repository pour tester la configuration du repository |
| `devin cloud drs run --devin-id <id> --command <cmd>` | Exécute une commande shell dans une session sandbox et attend la fin de son exécution |
| `devin cloud drs blueprint-list` | Répertorie tous les blueprints d’environnement de l’organisation |
| `devin cloud drs blueprint-create` | Crée un blueprint, éventuellement limité à un repository |
| `devin cloud drs blueprint-write --blueprint-id <id> --from-file <FILE>` | Remplace le contenu d’un blueprint par un fichier YAML |
| `devin cloud drs build` | Déclenche un build d’environnement et attend sa fin |
| `devin cloud drs build-start` | Déclenche un build et renvoie immédiatement l’ID du job de build |
| `devin cloud drs build-wait --build-job-id <id>` | Attend la fin d’un build lancé précédemment |
| `devin cloud drs build-logs --build-job-id <id>` | Diffuse les logs d’un job de build au format NDJSON — utile pour diagnostiquer les builds `partial` ou `failed` |
| `devin cloud drs secret-create --key <KEY> --from-env <VAR>` | Crée un secret au niveau de l’organisation ; la valeur est lue depuis une variable d’environnement, un fichier, un fichier dotenv ou stdin, jamais depuis la ligne de commande |
| `devin cloud drs secret-create --from-dotenv <PATH>` | Crée un secret au niveau de l’organisation pour chaque entrée d’un fichier dotenv |

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

**Options de `devin cloud drs secret-create` :**

Indiquez une seule source de valeur. La CLI lit elle-même la valeur : celle-ci ne transite pas par la ligne de commande et n’apparaît donc ni dans l’historique du shell, ni dans la sortie de `ps`, ni dans la transcription d’un agent.

La commande crée un secret au niveau de l’organisation, du même type que ceux ajoutés dans **Paramètres > Secrets**. Toutes les sessions Devin dans le cloud de l’organisation peuvent l’utiliser. Une session en cours y a accès dès la prochaine fois que Devin liste les secrets. Vous devez disposer de l’autorisation de gérer les secrets de l’organisation. La commande échoue si un secret portant le même nom existe déjà.

* `--key <KEY>` — Nom du secret (obligatoire, sauf si `--from-dotenv` est utilisé seul)
* `--from-env <VAR>` — Lit la valeur depuis cette variable d’environnement du processus de la CLI
* `--from-file <PATH>` — Lit la valeur depuis ce fichier (contenu intégral, sans le saut de ligne final)
* `--from-dotenv <PATH>` — Lit la valeur de `--key` depuis ce fichier dotenv. Sans `--key`, téléverse toutes les entrées du fichier
* `--stdin` — Lit la valeur depuis stdin (entrée intégrale, sans le saut de ligne final)
* `--only <KEY>` — Téléverse uniquement ces clés (répétable ; `--from-dotenv` sans `--key`)
* `--exclude <KEY>` — Ignore ces clés (répétable ; `--from-dotenv` sans `--key`)
* `--dry-run` — Affiche les clés qui seraient téléversées, sans les téléverser (`--from-dotenv` sans `--key`)

```bash theme={null}
devin cloud drs whoami
devin cloud drs blueprint-create --repo acme/api --from-file environment.yaml
devin cloud drs sandbox-create --repo acme/api --secret NPM_TOKEN=abc123
devin cloud drs run --devin-id devin-abc123 --command "npm test"
devin cloud drs build
devin cloud drs secret-create --key NPM_TOKEN --from-env NPM_TOKEN
devin cloud drs secret-create --key GCP_SA_JSON --from-file ./sa.json
op read "op://vault/item/token" | devin cloud drs secret-create --key API_TOKEN --stdin
devin cloud drs secret-create --key GH_TOKEN --from-dotenv .env
devin cloud drs secret-create --from-dotenv .env --exclude LOCAL_DB_URL --dry-run
```

Consultez la [référence Blueprint](https://docs.devin.ai/fr/onboard-devin/environment/blueprint-reference.md) pour connaître le format `environment.yaml` lu et écrit par ces commandes.

### devin connect

Connectez cette machine à une session Devin dans le cloud pour que la session puisse y exécuter des commandes et manipuler les fichiers qui s'y trouvent. La session affiche le code d'appairage lorsque Devin demande l'accès. Consultez [Local Hands](https://docs.devin.ai/fr/work-with-devin/local-hands.md).

```bash theme={null}
devin connect <CODE>
```

L’exécution de la commande approuve la connexion. La commande reste au premier plan jusqu’à la fin de la session ou jusqu’à ce que vous appuyiez sur `Ctrl+C`. Chaque appel d’outils nécessite toujours votre approbation dans la session, sauf si vous activez le mode Contournement.

**Options :**

* `--public` — Ne modifie pas la confidentialité de la session. Par défaut, une session dont vous êtes propriétaire devient privée (vous seul pouvez lui envoyer des messages) lorsque votre machine se connecte.

### devin version

Affiche la version actuelle, puis quitte.

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

Cela équivaut à `devin --version`.

### devin acp

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

**Options :**

| Indicateur | Var. d'env. | Description |
| - | - | - |
| `--agent-type <TYPE>` | | Le type d’agent à exécuter. Omettez cette option pour exécuter l’agent par défaut. |
| `--model <MODEL>` | `DEVIN_MODEL` | Modèle par défaut pour chaque nouvelle session ACP, remplaçant celui configuré à l’échelle de l’entreprise. Accepte les mêmes noms approximatifs que `/model` (slug de famille, alias ou nom partiel), par ex. `--model opus`. |

```bash theme={null}
devin acp --model opus
```

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

| Catégorie | Commandes |
| - | - |
| Compte | `/login [api-key]`, `/logout`, `/status` (nom ACP de `/login-status` dans la CLI) |
| Session | `/ask [question]`, `/plan [prompt]`, `/compact`, `/context`, `/fast`, `/btw <prompt>`, `/session-stats` (alias : `/stats`), `/help` |
| Système | `/workspace` (alias : `/workspaces`), `/add-dir <path>`, `/remove-dir <path>`, `/mcp`, `/bug <description>` |

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.

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

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

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

### devin setup

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

### devin doctor

Diagnostique la configuration locale de Devin. La commande indique quels profils de [sous-agents personnalisés](https://docs.devin.ai/fr/cli/subagents.md#custom-subagents) ont été chargés, signale toute définition `AGENT.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.

```bash theme={null}
devin doctor
devin doctor --json   # Sortie exploitable par une machine
```

### 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 par `devin 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é.

```bash theme={null}
devin airgap doctor
devin airgap doctor --json   # Sortie exploitable par une machine
```

> [!NOTE]
>
> `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](https://docs.devin.ai/fr/cli/cloud.md). Encapsule la commande `ssh` 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](https://docs.devin.ai/fr/cli/ssh.md).

```bash theme={null}
devin ssh <session> [--gateway <host[:port]>] [ssh options...]
```

| Argument | Description |
| - | - |
| `<session>` | ID de session ou URL de session |
| `--gateway <host[:port]>` | Hôte du gateway SSH (par défaut, l'hôte `ssh.` de votre API Devin, par exemple `ssh.devin.ai`) |
| `[ssh options...]` | Options supplémentaires transmises à `ssh`, par exemple `-L 8080:localhost:8080` |

### 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'adresse `http://localhost:<port>`. S'exécute jusqu'à l'interruption par Ctrl-C.

```bash theme={null}
devin forward <session> <port>... [--gateway <host[:port]>]
```

Chaque port est au format `<port>` ou `<local>:<port>` :

```bash theme={null}
devin forward devin-abc123 3000          # http://localhost:3000
devin forward devin-abc123 8080:3000     # port local 8080 → port 3000 de la VM
```

### devin worker

Exécute l’interface CLI en tant que worker Outposts [Outposts](https://docs.devin.ai/fr/cloud/outposts/overview). Cette commande est masquée dans `devin --help` et documentée séparément : consultez la [référence Outposts](https://docs.devin.ai/fr/cloud/outposts/reference.md).

### 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 | smart | 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) | | | | |
| `/smart` | Passe en mode Smart (approuve automatiquement les actions qu’un modèle rapide considère comme sûres). Déploiement progressif — il est possible qu’il ne soit pas encore disponible sur votre compte. | | | | |
| `/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) | | | | |
| `/autonomous` | Passe en mode Autonomous (imposé par le sandbox ; nécessite `--sandbox`) | | | | |
| `/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.

### 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 [new title]` | Renommer la session actuelle. Sans titre, un titre est généré à partir de la conversation jusqu’à présent. Alias : `/title`, `/rename-session` |
| `/rm-session <session-id>` | Supprimer définitivement une session et toutes ses données |
| `/export` | Afficher les informations d’export. Utilisez l’indicateur 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 |
| `/remove-dir <path>` | Supprimer un répertoire d’espace de travail (autre nom pour `/undo-add-dir`) |

### Automatisation

| Commande | Description |
| - | - |
| `/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 |
| `/mcp` | Répertorie les serveurs MCP configurés et leur statut |

### 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. Appuyez sur `Entrée` sur une ligne pour la [réattribuer](https://docs.devin.ai/fr/cli/reference/keyboard-shortcuts.md#customizing-keybindings) et afficher l’identifiant `context.action` de chaque action |
| `/config` | Ouvrir l’éditeur de configuration interactif |
| `/bug [description]` | Signaler un bug aux développeurs de la Devin CLI |
| `/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 |
| `/login-status` | Afficher le statut de connexion et d’authentification (annoncé aux hôtes ACP sous le nom de `/status`) |
| `/org` | Sélectionner votre organisation Devin |
| `/copy` | Copier la dernière réponse dans le presse-papiers |
| `/feedback <up\|down>` | Évaluer la dernière réponse |
| `/mouse` | Activer ou désactiver la capture des événements de souris (clic/survol/défilement dans les menus) |
| `/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 |
| `/session-stats` | Afficher les statistiques de la session (alias : `/stats`) |
| `/compact` | Forcer la compaction de la conversation |

#### 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](https://docs.devin.ai/fr/cli/cloud.md) pour un guide sur l'exécution de sessions Devin Cloud depuis le terminal.

| Commande | Description |
| - | - |
| `/cloud` | Basculer une nouvelle session locale pour qu'elle s'exécute dans Devin Cloud (avant le premier message ; sinon, exécutez d'abord `/clear`) |
| `/handoff [task]` | Session locale : poursuivre la tâche dans une session Devin dans le cloud. Session Devin dans le cloud : récupérer la branche de la pull request de la session et poursuivre en local. Voir [Passer le relais à des Devins dans le cloud](https://docs.devin.ai/fr/cli/handoff.md). |
| `/repo` | Choisir les repositories pour cette session Devin dans le cloud |
| `/platform` | Choisir la plateforme (OS) pour cette session Devin dans le cloud |
| `/open [web\|desktop]` | Ouvrir cette session Devin dans le cloud dans la web app (par défaut) ou dans Devin Desktop |
| `/ssh` | Se connecter en SSH à la VM de cette session Devin dans le cloud. Voir [SSH](https://docs.devin.ai/fr/cli/ssh.md). |
| `/pickup` | Récupérer la branche de la pull request de cette session Devin dans le cloud et poursuivre en local (équivalent à `/handoff` dans une session Devin dans le cloud) |
| `/rename <new title>` | Renommer cette session Devin dans le cloud |
| `/archive` | Archiver cette session Devin dans le cloud |

***

## Modes

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

> [tab] 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] 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] Smart
>
> Les modifications de l'espace de travail sont approuvées automatiquement, comme avec Accept Edits, et un modèle rapide détermine si les autres actions peuvent être exécutées automatiquement en toute sécurité ; sinon, la demande normale est affichée.
>
> * **Mode d'autorisation :** Smart
>
> * **Profil :** Normal
>
> * **À utiliser pour :** travail de développement courant (build, tests, linting) avec moins d'interruptions
>
> > [!NOTE]
> >
> > Le mode Smart est déployé progressivement et peut ne pas encore être disponible sur votre compte. Consultez les [autorisations](https://docs.devin.ai/fr/cli/reference/permissions.md).

> [tab] 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.

> [tab] Autonomous
>
> Tout, à l'exception des écritures de fichiers, est approuvé automatiquement, et le sandbox du système d'exploitation applique cette limite au lieu d'afficher des demandes d'autorisation.
>
> * **Mode d'autorisation :** Autonomous (nécessite `--sandbox`)
> * **Profil :** Normal
> * **À utiliser pour :** longues exécutions sans surveillance dans une session [sandboxée](https://docs.devin.ai/fr/cli/sandbox.md)

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.

| Profil | Description | Accès aux outils |
| - | - | - |
| `normal` | Assistant de programmation complet (utilisé par les modes Normal, Accept Edits, Smart, Bypass et Autonomous) | 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) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.