Aller au contenu
Références de fichiers

TUI

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.

Terminal
opencode

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

Terminal
opencode /path/to/project

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

Give me a quick summary of the codebase.

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.

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

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

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

Terminal
!ls -la

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

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

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

Voici toutes les commandes slash disponibles :

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

Terminal
/connect

Compactez la session en cours. Alias : /summarize

Terminal
/compact

Reliure de touches : ctrl+x c

Ouvrez un éditeur externe pour rédiger des messages. Utilise l’éditeur défini dans votre variable d’environnement EDITOR. En savoir plus.

Terminal
/editor

Reliure de touches : ctrl+x e

Quittez OpenCode. Alias : /quit, /q

Terminal
/exit

Reliure de touches : ctrl+x q

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.

Terminal
/export

Reliure de touches : ctrl+x x

Afficher la boîte de dialogue d’aide.

Terminal
/help

Reliure de touches : ctrl+x h

Créez ou mettez à jour le fichier AGENTS.md. En savoir plus.

Terminal
/init

Reliure de touches : ctrl+x i

Liste des modèles disponibles.

Terminal
/models

Reliure de touches : ctrl+x m

Démarrez une nouvelle session. Alias : /clear

Terminal
/new

Reliure de touches : ctrl+x n

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

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

Terminal
/redo

Reliure de touches : ctrl+x r

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

Terminal
/sessions

Reliure de touches : ctrl+x l

Répertoriez les thèmes disponibles.

Terminal
/theme

Reliure de touches : ctrl+x t

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.

Terminal
/thinking

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.

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

Terminal
/undo

Reliure de touches : ctrl+x u

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

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

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

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.

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

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.

  • theme - Définit votre thème d’interface utilisateur. En savoir plus.
  • keybinds - Personnalise les raccourcis clavier. En savoir plus.
  • 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 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.

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.