Éditeur et visionneuse

Lorsqu’un agent termine une modification, vous souhaitez la lire et décider si elle est correcte — sans quitter le cockpit pour VS Code. Le panneau d’édition et de visualisation de TermTree s’ouvre à côté du terminal dans ce but : il n’y a pas d’arborescence de fichiers, car le terminal en est déjà une, ni de LSP, de saisie semi-automatique ou de débogueur, car examiner le résultat produit par un agent est une tâche différente de l’écriture de code à partir de zéro.

Le terminal est votre explorateur de fichiers

TermTree ne comporte aucune arborescence de fichiers. À la place, le panneau d’édition et de visualisation ouvre tout fichier que vous désignez dans un terminal :

  • Faites un ⌘/Ctrl-clic sur tout chemin de fichier apparaissant dans la sortie du terminal pour l’ouvrir.
  • Les chemins écrits sous forme d’hyperliens OSC 8 (utilisés par certains outils et shells) sont cliquables de la même manière.
  • Faites un clic droit sur un chemin pour choisir Ouvrir le fichier / Ouvrir le dossier — consultez Terminaux.

Il existe un seul panneau global d’édition et de visualisation, partagé dans toute l’application — l’ouverture d’un fichier depuis n’importe quel terminal l’affiche dans ce même panneau.

Modification et enregistrement

Les fichiers texte s’ouvrent dans un éditeur CodeMirror qui détecte le langage afin d’appliquer la coloration syntaxique. Modifiez-les normalement, puis enregistrez-les avec Cmd+S / Ctrl+S. Un indicateur de modification non enregistrée apparaît à côté du nom du fichier.

Un seul fichier peut comporter des modifications non enregistrées à la fois. Si vous tentez de quitter un fichier comportant des modifications non enregistrées — en ouvrant un autre fichier ou en le fermant — TermTree vous invite à enregistrer ou abandonner les modifications, ou à annuler l’opération avant de continuer.

Lorsqu’un fichier change sur le disque

Si le fichier ouvert change sur le disque (par exemple, lorsqu’un agent le modifie dans un terminal) alors que votre tampon ne comporte aucune modification non enregistrée, TermTree le recharge automatiquement — aucune confirmation n’est nécessaire.

Si votre tampon comporte des modifications non enregistrées lorsque le fichier change sur le disque, TermTree ne remplace pas vos modifications. Il signale plutôt le fichier avec le message « Modifié sur le disque — Recharger », afin que vous puissiez examiner la modification externe et choisir de recharger le fichier une fois vos propres modifications traitées.

Volet du plan

Pour les fichiers Markdown, affichez ou masquez le volet Plan afin de voir l’arborescence des titres du fichier actuel. Cliquez sur un titre pour y accéder ; réduisez ou développez les branches pour parcourir les longs documents.

Affichage des différences

Cliquez sur Voir les modifications pour afficher une comparaison en lecture seule entre le fichier ouvert et le dernier commit (git HEAD) — un moyen rapide d’examiner ce qu’un agent a modifié avant de décider quoi conserver. Cette option n’apparaît que lorsque le fichier diffère réellement de HEAD. Les fichiers très volumineux sont exclus et un avis concernant la limite de taille s’affiche à la place de la comparaison.

Affichage des PDF et des images

Les fichiers .pdf et les formats d’image courants s’ouvrent dans une visionneuse dédiée en lecture seule plutôt que dans l’éditeur de texte.

L’éditeur conserve un historique de navigation à mesure que vous ouvrez des fichiers. Accédez au fichier précédent ou suivant avec Cmd+[ / Cmd+] (Ctrl+[ / Ctrl+], également disponibles sous la forme Ctrl+Alt+Left / Ctrl+Alt+Right dans le menu natif sous Windows/Linux).

Fichiers récents

Appuyez sur Cmd+Shift+O / Ctrl+Shift+O pour ouvrir la boîte de dialogue Fichiers récents — une liste sans doublons des fichiers que vous avez ouverts, limitée à 15 éléments. Chaque fois que vous l’ouvrez, les fichiers qui n’existent plus sur le disque en sont retirés, et la liste est conservée après les redémarrages.

Mémorisation de l’affichage par fichier

Pour chaque chemin de fichier, TermTree mémorise le dernier mode d’affichage utilisé (Éditeur ou Aperçu), ainsi que votre position de défilement dans chacun d’eux — lorsque vous revenez à un fichier, vous reprenez donc là où vous vous étiez arrêté. Les fichiers Markdown s’ouvrent par défaut en mode Aperçu ; tous les autres types de fichiers s’ouvrent par défaut en mode Éditeur. Cette mémoire est limitée à 50 fichiers et ne dure que pendant la session en cours — elle est effacée au redémarrage. Consultez Persistance de la session pour savoir ce qui est conservé ou non après un redémarrage.

Pour connaître le comportement de l’aperçu propre aux fichiers Markdown et HTML — images locales, liens entre fichiers, diagrammes Mermaid, rendu HTML en direct et exportation — consultez Aperçu et exportation.