Aller au contenu
OpenCode
app.header.homeapp.header.docs

TUI

Utilisation de l’interface utilisateur du terminal OpenCode.

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.

Fenêtre de terminal
opencode

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

Fenêtre de 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.

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.

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.

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

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

connecter

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

/connect

compact

Compactez la session en cours. Alias : /summarize

/compact

Reliure de touches : ctrl+x c

détails

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

/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

Reliure de touches : ctrl+x e

sortie

Quittez OpenCode. Alias : /quit, /q

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

/export

Reliure de touches : ctrl+x x

aide

Afficher la boîte de dialogue d’aide.

/help

Reliure de touches : ctrl+x h

initialisation

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

/init

Reliure de touches : ctrl+x i

modèles

Liste des modèles disponibles.

/models

Reliure de touches : ctrl+x m

nouveau

Démarrez une nouvelle session. Alias : /clear

/new

Reliure de touches : ctrl+x n

refaire

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.

/redo

Reliure de touches : ctrl+x r

séances

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

/sessions

Reliure de touches : ctrl+x l

partager

Partager la session en cours. En savoir plus.

/share

Reliure de touches : ctrl+x s

thèmes

Répertoriez les thèmes disponibles.

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

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

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

/undo

Reliure de touches : ctrl+x u

annuler le partage

Annuler le partage de la session en cours. En savoir plus.

/unshare

Configuration de l’éditeur

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

Fenêtre de 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.

Configurer

Vous pouvez personnaliser le comportement de TUI via votre fichier de configuration OpenCode.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    }
  }
}

Options

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