Démarrage

Ce guide vous accompagne de l’installation jusqu’à votre premier terminal et votre première session d’agent IA. Il suffit pour commencer à travailler ; chaque fonctionnalité est décrite en détail dans les autres chapitres (voir la présentation du manuel).

1. Présentation de VelaTerm

VelaTerm est un gestionnaire de terminaux conçu pour travailler avec des agents de codage IA. Il organise les sessions de terminal et d’agent dans une arborescence projet → groupe → session et exécute les agents de codage tels que Claude Code et Codex dans des sessions dédiées : vous voyez à tout moment si un agent travaille, attend une intervention de votre part ou a terminé, et la réouverture d’une session poursuit sa conversation. Les agents peuvent s’exécuter dans leur propre interface de terminal ou dans une vue conversation qui présente les messages, des cartes d’outils et des boutons d’autorisation. L’accès distant par navigateur et le développement à distance par SSH vous permettent de poursuivre vos sessions depuis d’autres appareils.

2. Installation

Téléchargez le paquet correspondant à votre plateforme depuis la page de téléchargement :

VelaTerm recherche automatiquement les mises à jour ; l’élément « Check for Updates… » du menu de l’application lance une vérification immédiate.

3. Premier lancement : ajouter un projet

Au premier lancement, la barre latérale est vide et propose trois façons d’ajouter un projet :

• « Créer un projet » crée un nouveau dossier et l’ajoute.
• « Ouvrir un projet » (⌘O, ou Ctrl+Alt+O sous Windows et Linux) ajoute un dossier existant.
• « Cloner depuis Git » clone un dépôt et l’ajoute.

Les mêmes actions sont disponibles sous forme de boutons dans l’en-tête de la barre latérale. Dans un projet, vous pouvez créer des groupes, imbriqués sur autant de niveaux que vous le souhaitez (par exemple frontend, backend, tests), et y placer des sessions :

4. Ouvrir votre premier terminal

Chacune des méthodes suivantes ouvre un terminal temporaire :

1. Appuyez sur ⌘T (Ctrl+Alt+T sous Windows et Linux).
2. Survolez un projet, un groupe ou une session dans la barre latérale, cliquez sur le bouton ＋, puis choisissez « Nouveau terminal ». Le terminal démarre dans le répertoire de ce nœud. Les menus contextuels des projets et des groupes proposent le même élément.
3. Lorsque le volet central est vide, cliquez sur « Créer un terminal ».

Les terminaux temporaires n’existent que sous forme d’onglets : ils ne deviennent jamais des nœuds de l’arborescence et sont supprimés à leur fermeture, ce qui les rend pratiques pour exécuter des commandes rapides.

5. Ouvrir votre première session d’agent IA

Cliquez avec le bouton droit sur un projet ou un groupe, puis choisissez « Nouvelle session Claude ». Le premier niveau du menu propose Claude, Codex et OpenCode ; « Plus de sessions agent » répertorie les quatorze agents pris en charge. Vous pouvez aussi appuyer sur ⌘N (Ctrl+Alt+N sous Windows, sous Linux et dans les navigateurs web standard) pour ouvrir une liste d’agents avec champ de recherche.

VelaTerm démarre l’agent dans le répertoire du projet. Les sessions Claude, Codex, OpenCode, Pi et OMP s’ouvrent dans la vue conversation : saisissez votre message dans la zone située en bas, puis appuyez sur Entrée. Les autres agents s’ouvrent dans la vue terminal, qui affiche l’interface de terminal propre à l’agent. Le bouton de bascule de l’en-tête du volet fait passer une session d’une vue à l’autre ; voir Vue conversation.

Vous bénéficiez dès lors de trois fonctionnalités :

• Points d’état : le point affiché à côté de la session dans la barre latérale indique l’état de l’agent. Le vert signifie qu’il travaille, le jaune qu’il a besoin de vous (pour une question ou une demande d’autorisation), et le magenta qu’il a répondu et que vous avez consulté sa réponse.
• Notifications système : lorsque l’agent s’arrête pour attendre votre intervention, vous recevez une notification. Si vous consultez déjà la session, aucune notification ne s’affiche.
• Reprise automatique : fermez l’onglet ou quittez l’application ; la prochaine fois que vous ouvrirez la session, la conversation reprendra là où elle s’était arrêtée. Pour démarrer une nouvelle conversation, créez une nouvelle session.

Si l’outil en ligne de commande de l’agent n’est pas encore installé, la session affiche une carte d’installation qui indique la commande d’installation recommandée pour votre système, avec un bouton « Installer ».

6. Présentation rapide de la fenêtre

• Barre latérale gauche : l’arborescence des projets, avec un champ de recherche et un filtre d’état. Boutons de l’en-tête : Créer un projet, Importer un projet, Cloner depuis Git, Rechercher dans toutes les sessions et Sessions archivées.
• Volet central : la barre d’onglets et les sessions ouvertes. Par défaut, un clic sur une session d’agent dans l’arborescence réutilise l’onglet actif, et l’onglet précédent continue de s’exécuter en arrière-plan. La fermeture d’un onglet met fin à ses processus. Un onglet peut être divisé en volets (⌘D à droite, ⌘⇧D en bas).
• Panneau de droite : il suit la session active et comporte quatre onglets : Fichiers, Infos (détails de la session, utilisation du compte, contexte et consommation des ressources), Git (branche, modifications et commits) et Base de connaissances.
• Barre d’état : nombre de sessions, type de la session active, branche Git, mode d’autorisation, activation des notifications et compteurs En cours / À traiter / Consulté. Cliquez sur un compteur pour n’afficher que les sessions correspondantes dans la barre latérale.
• Barre de titre, côté droit : choix du thème, Accès distant, Se connecter à un serveur distant, Partager, Paramètres, Compte, Votre avis, ainsi que les boutons qui affichent ou masquent les panneaux latéraux.

7. Pour aller plus loin

• Arborescence, onglets, volets, archivage et recherche globale : Gestion de l’interface et des sessions.
• Capacités des agents, reprise, fork et autorisations : Sessions d’agent IA.
• Travail dans la vue conversation : Vue conversation.
• Lancement de sessions enfants par les agents dans des worktrees distincts : Création de sessions et collaboration dans Git.
• Fonctionnalités du terminal (recherche, collage d’images, suggestions de commandes) : Utilisation du terminal.
• Utilisation de VelaTerm depuis un téléphone ou un autre ordinateur : Développement et gestion à distance.