---
title: TUI
description: Utilisation de l’interface utilisateur du terminal OpenCode.
---

import { Tabs, TabItem } from "@astrojs/starlight/components"

OpenCode fournit une interface de terminal interactif ou TUI pour travailler sur vos projets avec un LLM.

L’exécution de OpenCode démarre le TUI pour le répertoire actuel.

```bash
opencode
```

Ou vous pouvez le démarrer pour un répertoire de travail spécifique.

```bash
opencode /path/to/project
```

Une fois que vous êtes dans le TUI, vous pouvez lui envoyer un message.

```text
Give me a quick summary of the codebase.
```

---

## Références de fichiers

Vous pouvez référencer des fichiers dans vos messages en utilisant `@`. Cela effectue une recherche de fichier floue dans le répertoire de travail actuel.

:::tip
Vous pouvez également utiliser `@` pour référencer des fichiers dans vos messages.
:::

```text "@packages/functions/src/api/index.ts"
How is auth handled in @packages/functions/src/api/index.ts?
```

Le contenu du fichier est automatiquement ajouté à la conversation.

---

## Commandes Bash

Démarrez un message avec `!` pour exécuter une commande shell.

```bash frame="none"
!ls -la
```

Le résultat de la commande est ajouté à la conversation en tant que résultat de l'outil.

---

## Commandes

Lorsque vous utilisez le OpenCode TUI, vous pouvez taper `/` suivi d'un nom de commande pour exécuter rapidement des actions. Par exemple:

```bash frame="none"
/help
```

La plupart des commandes ont également une liaison clavier utilisant `ctrl+x` comme touche leader, où `ctrl+x` est la touche leader par défaut. [En savoir plus](/docs/keybinds).

Voici toutes les commandes slash disponibles :

---

### connect

Ajoutez un fournisseur à OpenCode. Vous permet de sélectionner parmi les fournisseurs disponibles et d’ajouter leurs clés API.

```bash frame="none"
/connect
```

---

### compact

Compactez la session en cours. *Alias* : `/summarize`

```bash frame="none"
/compact
```

**Reliure de touches :** `ctrl+x c`

---

### details

Basculer les détails d'exécution de l'outil.

```bash frame="none"
/details
```

**Reliure de touches :** `ctrl+x d`

---

### editor

Ouvrez un éditeur externe pour rédiger des messages. Utilise l'éditeur défini dans votre variable d'environnement `EDITOR`. [En savoir plus](#editor-setup).

```bash frame="none"
/editor
```

**Reliure de touches :** `ctrl+x e`

---

### exit

Quittez OpenCode. *Alias* : `/quit`, `/q`

```bash frame="none"
/exit
```

**Reliure de touches :** `ctrl+x q`

---

### export

Exportez la conversation en cours vers Markdown et ouvrez-la dans votre éditeur par défaut. Utilise l'éditeur défini dans votre variable d'environnement `EDITOR`. [En savoir plus](#editor-setup).

```bash frame="none"
/export
```

**Reliure de touches :** `ctrl+x x`

---

### help

Afficher la boîte de dialogue d'aide.

```bash frame="none"
/help
```

**Reliure de touches :** `ctrl+x h`

---

### init

Créez ou mettez à jour le fichier `AGENTS.md`. [En savoir plus](/docs/rules).

```bash frame="none"
/init
```

**Reliure de touches :** `ctrl+x i`

---

### models

Liste des modèles disponibles.

```bash frame="none"
/models
```

**Reliure de touches :** `ctrl+x m`

---

### new

Démarrez une nouvelle session. *Alias* : `/clear`

```bash frame="none"
/new
```

**Reliure de touches :** `ctrl+x n`

---

### redo

Refaire un message précédemment annulé. Disponible uniquement après avoir utilisé `/undo`.

:::tip
Toutes les modifications de fichiers seront également restaurées.
:::

En interne, cela utilise Git pour gérer les modifications de fichiers. Votre projet **doit donc
être un dépôt Git**.

```bash frame="none"
/redo
```

**Reliure de touches :** `ctrl+x r`

---

### sessions

Répertoriez et basculez entre les sessions. *Alias* : `/resume`, `/continue`

```bash frame="none"
/sessions
```

**Reliure de touches :** `ctrl+x l`

---

### share

Partager la session en cours. [En savoir plus](/docs/share).

```bash frame="none"
/share
```

**Reliure de touches :** `ctrl+x s`

---

### theme

Répertoriez les thèmes disponibles.

```bash frame="none"
/theme
```

**Reliure de touches :** `ctrl+x t`

---

### thinking

Activez/désactivez la visibilité des blocages de réflexion/raisonnement dans la conversation. Lorsque cette option est activée, vous pouvez voir le processus de raisonnement du modèle pour les modèles prenant en charge la réflexion étendue.

:::note
Cette commande contrôle uniquement si les blocs de réflexion sont **affichés** ; elle n'active ni ne désactive les capacités de raisonnement du modèle. Pour basculer entre les capacités de raisonnement réelles, utilisez `ctrl+t` pour parcourir les variantes du modèle.
:::

```bash frame="none"
/thinking
```

---

### undo

Annuler le dernier message de la conversation. Supprime le message utilisateur le plus récent, toutes les réponses ultérieures et toutes les modifications de fichier.

:::tip
Toutes les modifications apportées au fichier seront également annulées.
:::

En interne, cela utilise Git pour gérer les modifications de fichiers. Votre projet **doit donc
être un dépôt Git**.

```bash frame="none"
/undo
```

**Reliure de touches :** `ctrl+x u`

---

### unshare

Annuler le partage de la session en cours. [En savoir plus](/docs/share#un-sharing).

```bash frame="none"
/unshare
```

---

## Configuration de l'éditeur

Les commandes `/editor` et `/export` utilisent l'éditeur spécifié dans votre variable d'environnement `EDITOR`.

<Tabs>
  <TabItem label="Linux/macOS">
    ```bash
    # Example for nano or vim
    export EDITOR=nano
    export EDITOR=vim

    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
    # include --wait
    export EDITOR="code --wait"
    ```

Pour le rendre permanent, ajoutez-le à votre profil shell ;
`~/.bashrc`, `~/.zshrc`, etc.

  </TabItem>

  <TabItem label="Windows (CMD)">
    ```bash
    set EDITOR=notepad

    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
    # include --wait
    set EDITOR=code --wait
    ```

Pour le rendre permanent, utilisez **Propriétés système** > **Environnement
Variables**.

  </TabItem>

  <TabItem label="Windows (PowerShell)">
    ```powershell
    $env:EDITOR = "notepad"

    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
    # include --wait
    $env:EDITOR = "code --wait"
    ```

Pour le rendre permanent, ajoutez-le à votre profil PowerShell.

  </TabItem>
</Tabs>

Les options d'éditeur populaires incluent :

- `code`-Code Visual Studio
- `cursor` - Curseur
- `windsurf` - Planche à voile
- `nvim` - Editeur Neovim
- `vim` - Éditeur Vim
- `nano` - Éditeur nano
- `notepad` - Windows Bloc-notes
- `subl` - Texte sublime

:::note
Certains éditeurs comme VS Code doivent être démarrés avec le drapeau `--wait`.
:::

Certains éditeurs ont besoin d'arguments de ligne de commande pour s'exécuter en mode blocage. L'indicateur `--wait` bloque le processus de l'éditeur jusqu'à sa fermeture.

---

## Configurer

Vous pouvez personnaliser le comportement de TUI via `tui.json` (ou `tui.jsonc`).

```json title="tui.json"
{
  "$schema": "https://opencode.ai/tui.json",
  "theme": "opencode",
  "leader_timeout": 2000,
  "keybinds": {
    "leader": "ctrl+x",
    "command_list": "ctrl+p"
  },
  "scroll_speed": 3,
  "scroll_acceleration": {
    "enabled": false
  },
  "diff_style": "auto",
  "mouse": true,
  "attention": {
    "enabled": true,
    "notifications": true,
    "sound": true,
    "volume": 0.4,
    "sound_pack": "opencode.default",
    "sounds": {
      "error": "./sounds/error.mp3"
    }
  }
}
```

Ceci est séparé de `opencode.json`, qui configure le comportement du serveur/d'exécution.

`keybinds` est fusionné avec les valeurs par défaut intégrées, vous ne devez donc configurer que les raccourcis que vous souhaitez modifier.

### Options

- `theme` - Définit votre thème d'interface utilisateur. [En savoir plus](/docs/themes).
- `keybinds` - Personnalise les raccourcis clavier. [En savoir plus](/docs/keybinds).
- `leader_timeout` - Contrôle la durée pendant laquelle OpenCode attend après la leader key. Valeur par défaut : `2000`.
- `scroll_acceleration.enabled` - Activez l'accélération de défilement de style macOS pour un défilement fluide et naturel. Lorsqu'elle est activée, la vitesse de défilement augmente avec les gestes de défilement rapides et reste précise pour les mouvements plus lents. **Ce paramètre est prioritaire sur `scroll_speed` et le remplace lorsqu'il est activé.**
- `scroll_speed` - Contrôle la vitesse de défilement du TUI lors de l'utilisation des commandes de défilement (minimum : `0.001`, prend en charge les valeurs décimales). La valeur par défaut est `3`. **Remarque : Ceci est ignoré si `scroll_acceleration.enabled` est défini sur `true`.**
- `diff_style` - Contrôle le rendu différentiel. `"auto"` s'adapte à la largeur du terminal, `"stacked"` affiche toujours une seule colonne.
- `mouse` - Active ou désactive la capture de la souris dans le TUI (valeur par défaut : `true`). Lorsque cette option est désactivée, le comportement natif du terminal pour la sélection et le défilement à la souris est conservé.
- `attention` - Configure les notifications de bureau et les sons du TUI. Désactivé par défaut.

Utilisez `OPENCODE_TUI_CONFIG` pour charger un chemin de configuration TUI personnalisé.

### Attention

Attention permet au TUI de vous prévenir quand OpenCode attend une réponse, une autorisation, qu'une erreur de session doit être consultée ou qu'une session est terminée. Activez-le avec `attention.enabled` ; les événements intégrés jouent un son lorsqu'ils se produisent. Les notifications de bureau ne sont envoyées que lorsque la fenêtre du terminal n'est pas au premier plan, et elles ne sont pas utilisées pour les événements de subagent.

- `enabled` - Active toutes les notifications et tous les sons d'Attention. Valeur par défaut : `false`.
- `notifications` - Lorsque Attention est activé, autorise le TUI à envoyer des notifications de bureau via le terminal. Valeur par défaut : `true`.
- `sound` - Lorsque Attention est activé, autorise la lecture des sons d'alerte. Valeur par défaut : `true`.
- `volume` - Volume par défaut des sons, de `0` à `1`. Valeur par défaut : `0.4`.
- `sound_pack` - ID du sound pack à utiliser. Valeur par défaut : `opencode.default`.
- `sounds` - Définit des fichiers sonores personnalisés pour `default`, `question`, `permission`, `error`, `done` ou `subagent_done`. Les chemins peuvent être absolus, des URL `file://` ou relatifs à `tui.json`.

---

## Personnalisation

Vous pouvez personnaliser divers aspects de la vue TUI à l'aide de la palette de commandes (`ctrl+x h` ou `/help`). Ces paramètres persistent lors des redémarrages.

---

#### Affichage du nom d'utilisateur

Indiquez si votre nom d'utilisateur apparaît dans les messages de discussion. Accédez-y via :

- Palette de commandes : recherchez "nom d'utilisateur" ou "masquer le nom d'utilisateur"
- Le paramètre persiste automatiquement et sera mémorisé au cours de TUI sessions.
