Gestion de l’interface et des sessions

Ce chapitre présente le modèle d’organisation de VelaTerm : la disposition de la fenêtre, la gestion de l’arborescence, le comportement des onglets et des volets, les points d’état et le filtrage, l’archivage, la recherche globale et l’enregistrement de l’espace de travail à la fermeture. Les autres chapitres s’appuient sur ces notions.

1. Disposition de la fenêtre

« Accès distant » et « Se connecter à un serveur distant » sont disponibles dans l’application de bureau ; voir Développement et gestion à distance. Le bouton « Votre avis » ouvre la page d’avis de VelaTerm dans votre navigateur. Sous Windows et Linux, la touche Alt affiche une barre de menus avec Fichier, Terminal et Aide.

Les deux panneaux latéraux peuvent être masqués à l’aide des boutons de la barre de titre et redimensionnés en faisant glisser leur bord.

2. L’arborescence : projets, collections, groupes, sessions

• Un projet est un répertoire sur le disque et la racine d’une sous-arborescence. Pour en créer un, utilisez « Créer un projet » (crée un nouveau dossier), « Importer un projet » (ouvre un dossier existant, ⌘O) ou « Cloner depuis Git ».
• Une collection est un conteneur de premier niveau sans dossier, destiné aux sessions qui n’appartiennent pas à un projet précis. Créez-la avec le bouton « Nouvelle collection » en bas de la barre latérale.
• Un groupe est un nœud d’organisation, qui peut être imbriqué sur autant de niveaux que nécessaire.
• Une session est l’unité de travail : un agent, une page de navigateur ou un terminal. Son répertoire de travail est par défaut la racine du projet ; vous pouvez le modifier dans le formulaire « Modifier » de la session.

Au survol d’une ligne, un bouton ＋ apparaît (« Nouvelle session » sur les projets et les groupes, « Nouvelle session enfant » sur les sessions), ainsi qu’un bouton de création de groupe sur les projets et les groupes.

La plupart des opérations se trouvent dans les menus contextuels :

Les menus des projets et des groupes commencent par les éléments de création :

• « Nouvelle page de navigateur » (application de bureau) et « Nouveau terminal », qui ouvre un terminal temporaire dans ce répertoire (§5).
• Trois éléments directs « Nouvelle session … » pour les agents utilisés récemment, et « Plus de sessions agent », qui regroupe tous les agents, les préréglages enregistrés, « Nouvelle session d’agent » (le sélecteur avec recherche) et « Nouveau avec arguments… ».
• « Nouvelle session worktree… » et « Nouvelle session planification/exécution… » ; voir Création de sessions et collaboration dans Git et Planification et exécution.
• « Importer des sessions… » (projets uniquement) et « Reprendre une session… » ; voir Sessions d’agent IA, §4.

Le menu d’un projet propose ensuite « Nouveau groupe », « Repère », « Expérimental » (Graphe du code et Audit de code), « Infos du projet » (ou « Infos de la collection »), « Renommer » et « Retirer le projet » (ou « Supprimer la collection »). Le menu d’un groupe propose le sous-menu « Git », « Nouveau sous-groupe », « Déplacer vers un worktree… », « Repère », « Renommer », « Archiver le groupe » et « Supprimer le groupe ».

Les menus des sessions présentent les éléments adaptés au type et à l’état de la session :

• « Ouvrir », « Ouvrir dans un nouvel onglet », « Ouvrir dans un volet à droite », « Ouvrir dans un volet en bas », « Ouvrir dans le volet actif » (§4).
• « Nouvelle session enfant », « Forker la session », « Exporter la session… », « Organiser dans la base de connaissances des sessions » et le sous-menu « Git ».
• « Repère », « Infos de session » (maintenez la touche Option/Alt enfoncée pour afficher la commande de lancement complète), « Modifier », « Renommer », « Déplacer vers… ».
• « Tuer le processus » (pendant l’exécution), « Archiver la session », « Supprimer la session ».

Autres opérations sur l’arborescence :

• Déplacement : faites glisser les nœuds ou utilisez « Déplacer vers… ». Une session peut être déplacée sous une autre session pour en devenir l’enfant.
• Renommage : « Renommer » permet de modifier le nom directement dans l’arborescence. Une session que vous ne nommez pas prend le nom de votre premier message.
• Repères : « Repère » ajoute un marqueur emoji à un projet, un groupe ou une session : 🔥 Urgent, ⭐ Important, 🐛 Bogue, ✅ Terminé, 🚧 En cours, 📌 Épinglé, 💡 Idée, ⚠️ Attention. Choisir de nouveau le marqueur actuel le retire.
• Sélection multiple : ⌘/Ctrl-clic ajoute une session à la sélection ou l’en retire, Maj-clic sélectionne une plage. Le menu contextuel propose alors « Ouvrir les sessions sélectionnées », « Disposer les sessions sélectionnées en mosaïque » (de deux à quatre sessions), « Déplacer la sélection vers… », « Archiver les sessions sélectionnées » et « Supprimer les N éléments sélectionnés ». Faire glisser une sélection déplace l’ensemble de ses éléments.
• L’état replié ou déplié des nœuds est conservé d’un redémarrage à l’autre.

3. Onglets

Paramètres ▸ Comportement ▸ « Onglets » détermine la façon dont les sessions s’ouvrent :

• Unique (par défaut) : un clic sur une session d’agent dans l’arborescence réutilise l’onglet de session actif, comme lorsque vous suivez un lien dans un navigateur. L’onglet que vous quittez passe en arrière-plan avec tous ses volets, et ses processus continuent de s’exécuter. Les sessions de terminal s’ouvrent dans leur propre onglet.
• Multiples : chaque session s’ouvre dans son propre onglet.

« Ouvrir dans un nouvel onglet » ouvre toujours un nouvel onglet. Dans les deux modes, le passage à un autre onglet n’interrompt rien ; la fermeture d’un onglet (⌘W ou ×) met fin à ses processus. Pour les sessions d’agent, cette opération est sans risque : la conversation est conservée, et la réouverture du nœud la reprend.

Les onglets en arrière-plan sont signalés dans la barre d’état par « Arrière-plan N/M » ; cliquez sur cet indicateur pour rappeler un onglet ou y mettre fin. En mode Unique, « Background limit » (32 par défaut) plafonne leur nombre. Au-delà de cette limite, l’onglet inactif le plus ancien en arrière-plan est fermé automatiquement. Si tous les onglets en arrière-plan travaillent ou attendent votre intervention, VelaTerm vous demande lequel fermer.

Détails de la barre d’onglets :

• ⌘1–9 (Ctrl+1–9 sous Windows et Linux) active un onglet selon sa position. Un clic avec le bouton central de la souris ferme un onglet.
• Le bouton ＋ situé après les onglets ouvre un terminal temporaire. Les boutons de droite ouvrent un nouveau terminal, un nouveau document, un onglet du navigateur intégré (application de bureau) et le Centre de jeux.
• Le menu contextuel d’un onglet propose « Fermer l’onglet », « Fermer les autres onglets », « Fermer les onglets à droite », « Fermer tous les onglets », « Passer en arrière-plan » (les processus de l’onglet continuent de s’exécuter), ainsi que les mêmes éléments de session que l’arborescence.

Les onglets de document et de navigateur sont présentés dans Onglets de documents et de navigateur.

4. Volets

Un onglet peut contenir plusieurs volets :

• ⌘D divise à droite et ⌘⇧D divise en bas (Ctrl+Alt+D et Ctrl+Alt+E sous Windows et Linux) ; l’en-tête du volet propose les mêmes boutons. Le nouveau volet est un terminal temporaire qui démarre dans le répertoire de travail du volet actif.
• Pour afficher une session existante dans l’onglet actif, utilisez « Ouvrir dans un volet à droite », « Ouvrir dans un volet en bas » ou « Ouvrir dans le volet actif » dans son menu, ou faites-la glisser de la barre latérale vers le volet central.
• « Disposer les sessions sélectionnées en mosaïque » réunit deux à quatre sessions sélectionnées dans un même onglet.
• Les sessions affichées dans un autre volet de l’onglet actif sont mises en évidence dans la barre latérale.

Les séparateurs peuvent être déplacés par glisser-déposer. Le maintien en arrière-plan s’applique à l’onglet entier : si vous quittez un onglet puis y revenez, sa disposition est conservée. ⌘W ferme le volet actif ; la fermeture du dernier volet ferme l’onglet.

5. Terminaux temporaires

« Nouveau terminal », ⌘T et le bouton ＋ de la barre d’onglets ouvrent un terminal temporaire. Celui-ci n’existe que sous forme d’onglet : il ne devient jamais un nœud de l’arborescence et est supprimé à sa fermeture. L’onglet porte la mention « temp ». Utilisez les terminaux temporaires pour les commandes rapides et réservez les travaux de longue durée aux sessions d’agent. Le menu d’un terminal temporaire est réduit : « Ouvrir », « Ouvrir dans un nouvel onglet », les éléments de division, « Renommer », « Infos de session » et « Fermer le brouillon ».

6. Points d’état et filtrage

Le point affiché à côté de chaque session d’agent indique son état : vert pendant que l’agent travaille, jaune lorsqu’il a besoin de vous, magenta lorsqu’il a répondu et que vous avez consulté la réponse. La légende complète figure dans Sessions d’agent IA, §3.

La barre d’état indique le nombre de sessions « En cours », « À traiter » (qui ont besoin de vous) et « Consulté » ; un compteur sans session est masqué. Cliquez sur un compteur pour n’afficher que les sessions correspondantes dans la barre latérale ; cliquez de nouveau dessus pour retirer le filtre.

La barre latérale dispose de ses propres outils :

• Le champ de recherche (« Rechercher sessions / groupes… ») filtre l’arborescence par nom.
• Le bouton de filtre (« Filtrer par état ») permet de sélectionner un ou plusieurs états et, séparément, un repère.
• Un filtre d’état conserve les sessions qui correspondaient au moment où vous l’avez appliqué, afin que la liste ne change pas pendant que vous travaillez. Lorsque « Ajout dynamique au filtre d’état » est activé (Paramètres ▸ Comportement, activé par défaut), les sessions qui commencent à correspondre sont ajoutées. « Actualiser le filtre d’état », en bas de la barre latérale, vérifie de nouveau toutes les sessions ; « Actualiser l’état », dans le menu d’une session, ne vérifie que cette session.
• « Scinder la vue de l’arbre vers le bas », en bas de la barre latérale, ajoute une seconde vue de l’arborescence avec sa propre recherche et ses propres filtres, par exemple une vue pour les sessions qui ont besoin de vous et une autre pour l’arborescence complète. Chaque vue supplémentaire peut être fermée.

7. Panneau de droite

• Fichiers : l’arborescence des fichiers du répertoire de travail de la session. Double-cliquez sur un fichier pour l’ouvrir dans un onglet de document.
• Infos : détails de la session, utilisation du compte, tour en cours et consommation des ressources ; voir Sessions d’agent IA, §8.
• Git : branche, modifications indexées et non indexées, fichiers non suivis, création de commits et historique des commits.
• Base de connaissances : la base de connaissances des sessions, les sessions archivées et vos bases de connaissances locales ; voir Bases de connaissances locales et Base de connaissances des sessions.

8. Archivage : ranger sans supprimer

Le travail terminé n’a pas besoin d’être supprimé. Cliquez avec le bouton droit sur une session → « Archiver la session » pour la masquer : la session et ses enfants quittent l’arborescence et leurs processus s’arrêtent, mais toutes les données sont conservées. « Archiver le groupe » archive toutes les sessions d’un groupe, et « Archiver les sessions sélectionnées » archive une sélection.

Les sessions archivées se trouvent dans la base de connaissances. Ouvrez-les avec le bouton « Sessions archivées » de l’en-tête de la barre latérale. Elles sont regroupées par projet, et le champ de recherche (« Rechercher dans les archives… ») porte sur leur contenu. Pour chaque session archivée :

• La conversation peut être consultée. Les sessions d’agent affichent leurs messages ; en l’absence de conversation, l’enregistrement du terminal est affiché s’il existe. Un second onglet répertorie les articles de connaissance générés à partir de la session.
• « Restaurer en session normale » la remet à sa place dans l’arborescence avec son identifiant de conversation intact ; son ouverture reprend donc la conversation d’origine.
• « Organiser dans la base de connaissances des sessions » en extrait des connaissances réutilisables.
• « Exporter le contexte complet en Markdown » (Claude et Codex) écrit l’intégralité de la conversation dans un fichier.
• « Supprimer définitivement (avec l’enregistrement) » est la seule action qui supprime les données.

9. Recherche globale (⌘⇧F)

« Rechercher dans toutes les sessions » (⌘⇧F, ou Ctrl+Alt+G sous Windows et Linux) porte sur le contenu de toutes les sessions : les conversations des agents et la sortie enregistrée des terminaux, et pas seulement les noms.

• Vous pouvez combiner plusieurs mots dans n’importe quel ordre ; les mots partiels et les textes en chinois, en japonais ou en coréen sont également trouvés. Les résultats sont classés par pertinence.
• Les résultats sont regroupés par session à gauche ; l’aperçu de droite met en évidence la correspondance en cours. ↑/↓ et Entrée parcourent les correspondances d’une session à l’autre.
• « Ouvrir la session » ouvre la session dans l’espace de travail.
• Les sessions archivées sont exclues, sauf si vous cochez « Inclure les archives ».

La recherche dans la sortie des terminaux n’est possible que si l’enregistrement des sessions est activé (Paramètres ▸ Avancé ▸ « Enregistrer les journaux de session », désactivé par défaut). La recherche porte toujours sur les conversations des agents.

10. Supprimer en toute sécurité

La suppression d’une session est définitive et emporte son enregistrement. Lorsque vous supprimez un groupe ou un projet qui contient des sessions archivées, ces archives sont conservées, et la restauration de l’une d’elles rétablit son projet et son groupe. En cas de doute, archivez d’abord : le contenu archivé peut toujours être restauré.

11. Quitter l’application et restaurer l’espace de travail

À la fermeture, VelaTerm affiche « Quitter VelaTerm ? » et arrête les sessions de terminal et d’agent en cours d’exécution. Si « Enregistrer l’espace de travail » est coché, le prochain démarrage rouvre les mêmes onglets et volets. Les sessions restaurées ne démarrent pas d’elles-mêmes : chaque volet affiche « Restauré depuis l’espace de travail enregistré. Aucun processus n’est encore en cours. » avec un bouton « Démarrer ». La case à cocher mémorise votre dernier choix.