--- 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 : --- ### connecter 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` --- ### détails Basculer les détails d'exécution de l'outil. ```bash frame="none" /details ``` **Reliure de touches :** `ctrl+x d` --- ### éditeur 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` --- ### sortie Quittez OpenCode. *Alias* : `/quit`, `/q` ```bash frame="none" /exit ``` **Reliure de touches :** `ctrl+x q` --- ### exporter 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` --- ### aide Afficher la boîte de dialogue d'aide. ```bash frame="none" /help ``` **Reliure de touches :** `ctrl+x h` --- ### initialisation Créez ou mettez à jour le fichier `AGENTS.md`. [En savoir plus](/docs/rules). ```bash frame="none" /init ``` **Reliure de touches :** `ctrl+x i` --- ### modèles Liste des modèles disponibles. ```bash frame="none" /models ``` **Reliure de touches :** `ctrl+x m` --- ### nouveau Démarrez une nouvelle session. *Alias* : `/clear` ```bash frame="none" /new ``` **Reliure de touches :** `ctrl+x n` --- ### refaire 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` --- ### séances Répertoriez et basculez entre les sessions. *Alias* : `/resume`, `/continue` ```bash frame="none" /sessions ``` **Reliure de touches :** `ctrl+x l` --- ### partager Partager la session en cours. [En savoir plus](/docs/share). ```bash frame="none" /share ``` **Reliure de touches :** `ctrl+x s` --- ### thèmes Répertoriez les thèmes disponibles. ```bash frame="none" /theme ``` **Reliure de touches :** `ctrl+x t` --- ### pensée 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 ``` --- ### défaire 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` --- ### annuler le partage 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`. ```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. ```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**. ```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. Les options d'éditeur populaires incluent : - `code`-Code Visual Studio - `cursor` - Curseur - `windsurf` - Planche à voile - `nvim` - Editeur Néovim - `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 votre fichier de configuration OpenCode. ```json title="opencode.json" { "$schema": "https://opencode.ai/config.json", "tui": { "scroll_speed": 3, "scroll_acceleration": { "enabled": true } } } ``` ### Possibilités - `scroll_acceleration` - 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 : `1`). La valeur par défaut est `3`. **Remarque : Ceci est ignoré si `scroll_acceleration.enabled` est défini sur `true`.** --- ## 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.