Utilisation du terminal

Ce chapitre porte sur le terminal lui-même : saisie et sortie, recherche dans le terminal, copier-coller, collage d’images, suggestions de commandes, commandes intégrées v, commandes en arrière-plan démarrées avec vrun, choix du shell sous Windows, enregistrement des sessions, réglages de rendu et raccourcis.

1. Notions de base

Une session de terminal exécute un véritable shell. Sous macOS et Linux, il s’agit du shell par défaut du système ($SHELL) ; sous Windows, il s’agit par défaut de cmd, et ce choix peut être modifié (voir le §7). Le répertoire de travail est par défaut la racine du projet. Le formulaire de modification de la session permet de changer le « Répertoire de travail (vide = racine du projet) » et de définir une « Commande de démarrage (optionnel) », exécutée à chaque démarrage de la session (par exemple pnpm dev).

Lorsque plusieurs agents produisent simultanément une grande quantité de sortie, VelaTerm donne la priorité à votre saisie et à l’onglet visible, et limite le débit de sortie des onglets en arrière-plan. Ce comportement est contrôlé par Paramètres ▸ Avancé ▸ « Sortie prioritaire au premier plan » (activé par défaut). Si l’affichage d’un programme plein écran est altéré après un changement d’onglet, cliquez sur le bouton « Redessiner » de l’en-tête du volet pour le réafficher. Paramètres ▸ Avancé ▸ « Redessiner au changement d’onglet » effectue automatiquement cette opération chaque fois qu’un onglet devient visible.

2. Recherche dans le terminal (⌘F)

⌘F ouvre une barre de recherche (« Rechercher dans le terminal ») qui porte sur l’historique de défilement du terminal actif, avec des boutons Précédent et Suivant :

Pour rechercher dans plusieurs sessions et dans l’historique, utilisez la recherche globale (⌘⇧F), décrite dans Gestion de l’interface et des sessions.

3. Copier-coller

• Sélectionnez du texte avec la souris, puis utilisez ⌘C / ⌘V ou le menu contextuel (« Copier », « Coller », « Tout sélectionner », « Effacer », « Rechercher… »).
• Dans les programmes qui capturent la souris (vim, htop, la plupart des interfaces d’agent), maintenez la touche Option sous macOS, ou Maj sous Windows et Linux, pendant que vous faites glisser la souris afin de forcer une sélection de texte normale.
• Les interfaces d’agent telles que Claude Code et Codex peuvent copier du texte elles-mêmes. Lorsqu’elles viennent de le faire et que rien n’est sélectionné dans le terminal, le menu contextuel affiche « N caractères copiés · ⌘V pour coller ».

4. Coller des images

Pour transmettre une image à un agent en ligne de commande, collez-la ou déposez-la dans le terminal. Paramètres ▸ Terminal ▸ « Collage d’image » propose deux choix :

• Coller le chemin (par défaut) : l’image est enregistrée dans un fichier temporaire, et son chemin est inséré à l’invite ; tout agent capable de lire des fichiers peut alors l’ouvrir. Codex la reçoit sous la forme image_path: ….
• Collage natif : Claude Code ou Codex lit l’image dans le presse-papiers du système et affiche son propre espace réservé pour l’image. Cette option n’est disponible que dans l’application de bureau locale ; les sessions distantes collent toujours un chemin de fichier, afin que l’agent puisse lire l’image sur sa propre machine.

Paramètres ▸ Comportement ▸ « Nettoyer automatiquement les images collées » supprime ces fichiers temporaires à la fermeture de l’application et efface au démarrage les fichiers restants datant de plus de 24 heures. « Nettoyer maintenant » les supprime immédiatement. Les images insérées dans des documents ne sont jamais concernées.

5. Suggestions de commandes

Dans les sessions de terminal classiques sous macOS et Linux, VelaTerm peut afficher une liste de suggestions construite à partir des définitions de complétion de votre shell. Paramètres ▸ Terminal ▸ « Suggestions de commandes » propose « Automatiques » (par défaut), « Avec Tab » ou « Désactivées ». Utilisez les touches fléchées pour sélectionner une proposition et Tab pour l’insérer ; Entrée exécute toujours la commande telle qu’elle a été saisie. Lorsque la sélection ne peut plus se déplacer, les touches Haut et Bas sont transmises au shell : Haut sur la première proposition rappelle donc la commande précédente. La liste n’est pas disponible sous Windows. Tous les détails figurent dans Suggestions de commandes.

6. Commandes intégrées

Chaque session démarrée par VelaTerm dispose d’un ensemble de commandes courtes dans son PATH. Elles ne nécessitent aucune installation et fonctionnent aussi bien dans les terminaux classiques que dans les sessions d’agent :

Exécutez une commande avec --help pour afficher ses options ; Commandes de session décrit chacune d’elles en détail. La plupart de ces commandes existent aussi sous forme de compétences dans Claude Code (/vopen) et Codex ($vopen) ; vrun et vflow n’ont pas de compétence, et vask n’existe que sous forme de compétence. Les compétences s’installent avec le bouton « Vela Skills » de Paramètres ▸ Général.

vopen choisit la vue selon le type de fichier :

vopen README.md          # Markdown → Markdown editor
vopen src/main.rs        # source code → code editor with syntax highlighting
vopen diagram.png        # image → image viewer
vopen https://crates.io  # web address → browser tab (desktop app only)

Les chemins relatifs sont résolus par rapport au répertoire courant, et plusieurs fichiers peuvent être ouverts à la fois. Les onglets de document sont présentés dans Onglets de documents et de navigateur ; vspawn est présenté dans Création de sessions et collaboration dans Git ; vkb est présenté dans Graphe du code et base de connaissances et Bases de connaissances locales.

6.1 Commandes en arrière-plan (vrun)

vrun <label> <command...> démarre une commande, attend qu’elle se termine, puis affiche le code de sortie, la durée écoulée et la fin de son journal. Un agent qui lance une compilation ou des tests de longue durée avec vrun prend donc connaissance du résultat dès qu’il est disponible. La fermeture de la session n’arrête pas la commande. vrun --status <label> rend compte d’une commande démarrée précédemment, et -t <seconds> définit la durée d’attente (1800 secondes par défaut) ; à l’expiration du délai, vrun se termine avec le code 124 et laisse la commande s’exécuter.

Pendant l’exécution de ces commandes, une ligne « Commandes en arrière-plan » apparaît au-dessus du terminal. Chaque entrée affiche son étiquette et « En cours depuis … », un bouton « Journal » qui ouvre la sortie de la commande et un bouton « Arrêter » ; cliquez sur « Confirmer l’arrêt » pour mettre fin à la commande. La ligne disparaît lorsque plus aucune commande n’est en cours.

7. Choix du shell (Windows uniquement)

Sous Windows, les sessions de terminal peuvent utiliser n’importe quel shell détecté : PowerShell, pwsh, cmd, Git Bash et chaque distribution WSL installée. Choisissez-le dans le sous-menu « Nouveau terminal », dans le champ « Shell (vide = défaut système) » du formulaire de modification de la session, ou dans le menu « Shell » du clic droit. Une session en cours d’exécution redémarre immédiatement avec le nouveau shell. Paramètres ▸ Terminal ▸ « Shell par défaut » définit le shell des nouveaux terminaux pour lesquels aucun choix explicite n’a été fait.

Les entrées WSL apparaissent sous la forme WSL: <distribution> uniquement lorsque WSL signale une distribution installée. Le choix de l’une d’elles démarre cette distribution et y rend accessible le répertoire de projet Windows de la session. WSL n’est disponible que pour les sessions de terminal classiques ; les sessions d’agent continuent d’utiliser le shell de l’hôte Windows. Les commandes intégrées v ne sont pas disponibles dans les terminaux WSL.

À propos du Git Bash fourni : le programme d’installation full inclut le Git Bash complet (avec git, ssh et perl). Le programme d’installation min inclut un sous-ensemble essentiel ; lorsque vous exécutez une commande manquante, il propose de télécharger la version complète, également disponible depuis l’élément « Télécharger Git Bash complet » du clic droit. Les sessions d’agent ne sont pas concernées : elles utilisent PowerShell.

macOS et Linux ne proposent pas de sélecteur de shell ; les sessions utilisent le shell par défaut du système.

8. Enregistrement des sessions

Paramètres ▸ Avancé ▸ « Enregistrer les journaux de session » est désactivé par défaut. Lorsque ce réglage est activé, VelaTerm enregistre dans un fichier journal local la sortie de terminal des sessions d’agent qui s’exécutent dans la vue terminal, dans la limite de 50 Mo par session. Les sessions de terminal classiques ne sont jamais enregistrées.

Un enregistrement permet de rejouer une session archivée telle qu’elle apparaissait à l’écran et rend son texte affiché accessible à la recherche. VelaTerm n’utilise un enregistrement que lorsque l’historique de conversation propre à l’agent ne peut pas être lu ; dans les autres cas, cet historique sert à l’affichage et à la recherche. Les fichiers d’enregistrement sont supprimés avec leur session.

9. Moteur de rendu

Paramètres ▸ Avancé ▸ « Moteur de rendu du terminal » propose DOM (par défaut) et WebGL. DOM est le choix recommandé dans l’application de bureau. Les versions précédentes proposaient aussi un moteur de rendu Canvas ; cette option n’existe plus, et une préférence Canvas enregistrée utilise désormais DOM.

10. Raccourcis courants

Le tableau indique les raccourcis par défaut de l’application de bureau macOS. Les applications Windows et Linux utilisent Ctrl+Alt au lieu de ⌘ pour la plupart des actions (la division vers le bas correspond à Ctrl+Alt+E, la recherche dans toutes les sessions à Ctrl+Alt+G, et l’enregistrement reste Ctrl+S). Les clients navigateur utilisent des raccourcis par défaut fondés sur Ctrl qui évitent ceux du navigateur. Paramètres ▸ Raccourcis indique les combinaisons exactes sur votre système ; toutes les actions, à l’exception du changement d’onglet et de la taille de police, peuvent y être modifiées.