Aller au contenu
OpenCode
HomeDocs

TUI

Utilisation de l'interface terminal utilisateur OpenCode.

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

Lancer OpenCode demarre la TUI pour le repertoire actuel.

Fenêtre de terminal
opencode

Ou vous pouvez la demarrer pour un repertoire de travail specifique.

Fenêtre de terminal
opencode /path/to/project

Une fois dans la TUI, vous pouvez lui envoyer un message.

Give me a quick summary of the codebase.

References de fichiers

Vous pouvez faire reference a des fichiers dans vos messages en utilisant @. Cela effectue une recherche de fichiers approximative dans le repertoire de travail actuel.

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

Le contenu du fichier est ajoute automatiquement a la conversation.

Commandes Bash

Commencez un message par ! pour executer une commande shell.

!ls -la

La sortie de la commande est ajoutee a la conversation en tant que resultat d’outil.

Commandes

Lors de l’utilisation de la TUI OpenCode, vous pouvez taper / suivi d’un nom de commande pour executer rapidement des actions. Par exemple :

/help

La plupart des commandes ont egalement un raccourci clavier utilisant ctrl+x comme touche de leader, ou ctrl+x est la touche de leader par defaut. En savoir plus.

Voici toutes les commandes slash disponibles :

connect

Ajouter un fournisseur a OpenCode. Vous permet de selectionner parmi les fournisseurs disponibles et d’ajouter leurs cles API.

/connect

compact

Compacter la session actuelle. Alias: /summarize

/compact

Raccourci: ctrl+x c

details

Basculer les details d’execution des outils.

/details

Raccourci: ctrl+x d

editor

Ouvrir l’editeur externe pour composer des messages. Utilise l’editeur defini dans votre variable d’environnement EDITOR. En savoir plus.

/editor

Raccourci: ctrl+x e

exit

Quitter OpenCode. Alias: /quit, /q

/exit

Raccourci: ctrl+x q

export

Exporter la conversation actuelle vers Markdown et l’ouvrir dans votre editeur par defaut. Utilise l’editeur defini dans votre variable d’environnement EDITOR. En savoir plus.

/export

Raccourci: ctrl+x x

help

Afficher la boite de dialogue d’aide.

/help

Raccourci: ctrl+x h

init

Creer ou mettre a jour le fichier AGENTS.md. En savoir plus.

/init

Raccourci: ctrl+x i

models

Lister les modeles disponibles.

/models

Raccourci: ctrl+x m

new

Demarrer une nouvelle session. Alias: /clear

/new

Raccourci: ctrl+x n

redo

Refaire un message precedemment annule. Disponible uniquement apres avoir utilise /undo.

En interne, cela utilise Git pour gerer les changements de fichiers. Votre projet doit donc etre un depot Git.

/redo

Raccourci: ctrl+x r

sessions

Lister et basculer entre les sessions. Alias: /resume, /continue

/sessions

Raccourci: ctrl+x l

share

Partager la session actuelle. En savoir plus.

/share

Raccourci: ctrl+x s

themes

Lister les themes disponibles.

/theme

Raccourci: ctrl+x t

undo

Annuler le dernier message de la conversation. Supprime le message utilisateur le plus recent, toutes les reponses subsequentes et tous les changements de fichiers.

En interne, cela utilise Git pour gerer les changements de fichiers. Votre projet doit donc etre un depot Git.

/undo

Raccourci: ctrl+x u

unshare

Annuler le partage de la session actuelle. En savoir plus.

/unshare

Configuration de l’editeur

Les commandes /editor et /export utilisent toutes deux l’editeur specifie dans votre variable d’environnement EDITOR.

Fenêtre de terminal
# Exemple pour nano ou vim
export EDITOR=nano
export EDITOR=vim


# Pour les editeurs GUI, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# inclure --wait
export EDITOR="code --wait"

Pour rendre cela permanent, ajoutez-le a votre profil de shell ; ~/.bashrc, ~/.zshrc, etc.

Les options d’editeur populaires incluent :

  • code - Visual Studio Code
  • cursor - Cursor
  • windsurf - Windsurf
  • nvim - Editeur Neovim
  • vim - Editeur Vim
  • nano - Editeur Nano
  • notepad - Bloc-notes Windows
  • subl - Sublime Text

Certains editeurs ont besoin d’arguments en ligne de commande pour fonctionner en mode blocage. L’indicateur --wait fait en sorte que le processus de l’editeur bloque jusqu’a sa fermeture.

Configurer

Vous pouvez personnaliser le comportement de la 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 - Activer l’acceleration de defilement style macOS pour un defilement fluide et naturel. Lorsqu’elle est activee, la vitesse de defilement augmente avec les mouvements de defilement rapides et reste precise pour les mouvements plus lents. Ce parametre prend le pas sur scroll_speed et le remplace lorsqu’il est active.
  • scroll_speed - Controle la vitesse de defilement de la TUI lors de l’utilisation des commandes de defilement (minimum: 1). Par defaut a 1 sur Unix et 3 sur Windows. Remarque: Ceci est ignore si scroll_acceleration.enabled est defini a true.

Personnalisation

Vous pouvez personnaliser divers aspects de la vue TUI en utilisant la palette de commandes (ctrl+x h ou /help). Ces parametres persistent entre les redemarrages.

Affichage du nom d’utilisateur

Activez ou desactivez l’affichage de votre nom d’utilisateur dans les messages de chat. Accedez-y via :

  • Palette de commandes: Recherchez “username” ou “hide username”
  • Le parametre persiste automatiquement et sera memento entre les sessions TUI