Sessions d’agent IA

Ce chapitre explique comment VelaTerm héberge les agents de codage IA sous forme de sessions typées : agents pris en charge, état en temps réel, reprise automatique des conversations, importation et fork de conversations, modes d’autorisation, paramètres de lancement, aide à l’installation et panneau Infos. La vue conversation fait l’objet d’un chapitre distinct : Vue conversation.

1. Agents pris en charge

VelaTerm peut démarrer les agents suivants : Claude Code (affiché sous le nom « Claude »), Codex, OpenCode, Copilot, Cursor, Antigravity, Cline, Pi, OMP, Crush, Kimi Code, Kiro, Grok Build et Zoo Code. L’outil en ligne de commande de chaque agent doit être installé et connecté à un compte.

Les capacités varient selon l’agent :

• Transmis par l’agent signifie que l’agent informe lui-même VelaTerm lorsqu’il commence à travailler, a besoin de vous ou termine ; l’état affiché est donc exact. Codex signale chaque étape lorsque sa version prend en charge les hooks de cycle de vie ; les versions plus anciennes de Codex ne signalent que la fin d’un tour. Lorsque la colonne « Besoin de vous » affiche ✗, l’agent ne signale ni ses questions ni ses demandes d’autorisation ; la session reste donc à l’état « En cours » jusqu’à la fin du tour.
• Lu à l’écran signifie que VelaTerm déduit l’état de l’agent de son interface de terminal.
• Pour Copilot, Cursor, Antigravity, Kimi Code, Kiro et Grok Build, VelaTerm ajoute ses propres entrées à la configuration utilisateur de l’agent lors du premier démarrage d’une telle session. Ces entrées sont sans effet lorsque l’agent s’exécute en dehors de VelaTerm.
• Les agents que vous lancez vous-même dans un terminal classique ne sont pas concernés ; la remontée de l’état ne s’applique qu’aux sessions d’agent démarrées par VelaTerm.

2. Créer une session d’agent

• Menu contextuel. Cliquez avec le bouton droit sur un projet, un groupe ou une session. Le premier niveau du menu propose trois agents : d’abord Claude, Codex et OpenCode, puis les trois types d’agent que vous avez créés le plus récemment. « Plus de sessions agent » répertorie tous les agents, vos préréglages enregistrés, « Nouveau avec arguments… » et « Nouvelle session d’agent » (le sélecteur avec recherche).
• Sélecteur de nouvelle session d’agent. ⌘N sous macOS (Ctrl+Alt+N sous Windows, sous Linux et dans les navigateurs web standard) ouvre une liste d’agents et de préréglages avec recherche ; les choix récents portent la mention « Dernier choix ». Voir Paramètres et raccourcis, §9.
• Sessions enfants. Le sous-menu « Nouvelle session enfant » d’une session crée la nouvelle session sous celle-ci. Des sessions peuvent aussi être démarrées depuis une conversation ; voir Création de sessions et collaboration dans Git.

Nouveau avec arguments… ouvre une boîte de dialogue qui comprend le type d’agent (« Type d’agent »), un nom facultatif (« Nom de session (vide = nommage auto) »), « Arguments de lancement (optionnel) », « Exécutable (facultatif) » pour utiliser un autre exécutable dans cette seule session, le réglage des autorisations, « S’ouvre en » (« Vue terminal » ou « Vue conversation ») pour les agents qui prennent en charge les deux vues, et un choix « Worktree ». « Enregistrer comme préréglage » enregistre ces réglages sous un nom, avec une icône facultative. Les préréglages apparaissent dans le menu et dans le sélecteur ; ils démarrent avec l’exécutable, les arguments et le réglage des autorisations enregistrés.

Les sessions Claude, Codex, OpenCode, Pi et OMP s’ouvrent par défaut dans la vue conversation ; les autres agents s’ouvrent dans la vue terminal. Paramètres ▸ Agents ▸ « Vue par défaut » permet de modifier ce comportement pour chaque agent.

3. Points d’état : qui travaille, qui a besoin de vous

Le point affiché à côté de chaque session d’agent est mis à jour en temps réel :

Lorsqu’un agent s’arrête pour attendre votre intervention (une question, une demande d’autorisation ou la fin d’un tour), vous recevez une notification système, la session est marquée comme non lue et le badge du Dock la comptabilise. Si vous consultez déjà cette session, aucune notification ne s’affiche. Dans la version signée pour macOS, un clic sur une notification ouvre la session. L’élément « Notify: On/Off » de la barre d’état active ou désactive les notifications système ; les marques de non-lecture et les badges restent affichés. Lorsque des badges sont présents, l’en-tête de la barre latérale affiche un bouton qui les efface tous.

Les compteurs « En cours », « À traiter » et « Consulté » de la barre d’état filtrent la barre latérale sur les sessions dans l’état correspondant ; voir Gestion de l’interface et des sessions, §6.

4. Reprise automatique : fermez, rouvrez, la conversation continue

Le principe en une phrase : chaque nœud de session d’agent de l’arborescence correspond à une conversation continue.

• Lors de la première exécution, VelaTerm mémorise l’identifiant de conversation propre à l’agent.
• Ensuite, que vous ayez fermé l’onglet ou quitté l’application, la réouverture du nœud poursuit la même conversation. Avant la reprise, VelaTerm vérifie que la conversation existe toujours ; si elle a été supprimée, la session démarre une nouvelle conversation au lieu d’échouer.
• Pour démarrer une nouvelle conversation, créez un nouveau nœud de session. Dans la vue conversation, /clear remplace la session par une nouvelle session vide au même emplacement.

Reprendre une session…, à la fin du menu Nouvelle session, ajoute une conversation existante, par exemple une conversation menée dans un terminal classique. Choisissez le « Type d’agent », collez l’identifiant de conversation de l’agent, puis choisissez « Reprendre et ouvrir ». Tous les types d’agent du §1 peuvent être repris de cette façon.

Importer des sessions…, dans le menu contextuel d’un projet, répertorie les conversations Codex, Claude, OpenCode et Kiro existantes dont le répertoire de travail est exactement celui du projet. Recherchez par titre, agent ou identifiant de session (« Rechercher par titre, agent ou ID de session »), sélectionnez des lignes, puis choisissez « Importer ». Les conversations rejoignent l’arborescence du projet ; ouvrez-en une pour la poursuivre. L’importation ne copie ni ne modifie l’historique propre à l’agent. Les conversations déjà présentes dans VelaTerm, y compris les conversations archivées, portent la mention « Déjà importée ». Les conversations situées dans des sous-répertoires ou dans des worktrees distincts n’apparaissent que si le répertoire concerné est ouvert comme projet à part entière. L’historique Kiro peut être consulté pour les enregistrements composés uniquement de texte. Lorsque vous êtes connecté à un VelaTerm distant, la liste provient de l’ordinateur distant.

5. Fork : créer une branche à partir d’une conversation

Pour les sessions Claude, Codex, Pi et OMP qui disposent déjà d’une conversation, cliquez avec le bouton droit → « Forker la session ». Cette action crée un nœud frère qui part de l’historique actuel de la conversation source et laisse celle-ci inchangée, à la manière d’une branche Git. Utilisez-la pour essayer deux approches à partir du même contexte.

6. Autorisations

Les réglages d’autorisation déterminent ce que l’agent peut faire sans vous demander votre accord.

• Claude, Codex et OpenCode disposent de modes nommés. Claude : « Mode plan », « Toujours demander », « Accepter les modifications », « Mode auto », « Sans confirmation ». Codex : « Lecture seule », « Mode auto », « Accès complet ». OpenCode : « Toujours demander », « Sans confirmation ».
• Copilot, Cursor, Antigravity, Cline, OMP, Crush, Kimi Code, Kiro, Grok Build et Zoo Code disposent d’une seule option, « Ignorer toutes les confirmations de permission », qui lance l’agent avec sa propre option de contournement. Dans la vue conversation, OMP propose « Toujours demander » et « Sans confirmation ».
• Pi exécute les outils sans demander d’autorisation ; il ne dispose donc d’aucun réglage d’autorisation.

Où modifier ce réglage :

• Pour une session : dans le formulaire « Modifier » de la session (« Permission », ou la case « Ignorer toutes les confirmations de permission ») ; dans la vue terminal, avec l’élément d’autorisation de la barre d’état (« Droits : Demander » / « Droits : Ignorer », ou le nom du mode actuel) ; dans la vue conversation, avec le contrôle des autorisations situé sous la zone de message.
• Valeur par défaut des nouvelles sessions : Paramètres ▸ Agents ▸ « Permission ». Les menus de la barre d’état et de la vue conversation permettent aussi de définir le choix actuel comme valeur par défaut.

Certaines modifications ne s’appliquent qu’après le redémarrage de l’agent. VelaTerm propose alors « Redémarrer » ou « Plus tard » ; le redémarrage reprend la conversation, mais interrompt une tâche en cours. « Sans confirmation », « Accès complet » et « Ignorer toutes les confirmations de permission » suppriment toutes les confirmations : utilisez-les avec prudence.

7. Paramètres de lancement et aide à l’installation

Arguments de lancement. Le formulaire « Modifier » de la session comporte le champ « Arguments de lancement (optionnel) », qui ajoute des arguments de ligne de commande pour cette session. Paramètres ▸ Agents contient une valeur par défaut pour chaque type d’agent.

Chemin de l’exécutable. Si un agent est installé en dehors de votre PATH, renseignez son « Chemin de l’exécutable (facultatif) » dans Paramètres ▸ Agents. Lorsque ce champ est vide, la commande est recherchée dans le PATH.

Agent non installé ? Le démarrage d’un agent qui n’est pas installé affiche une carte dans la session : « <Agent> n’est pas installé », avec la commande d’installation recommandée pour votre système.

• « Installer » exécute la commande dans la session. Lorsque le programme installé est détecté, son chemin est enregistré dans les paramètres et une boîte de dialogue propose « Relancer maintenant » ou « Plus tard ».
• « Relancer » redémarre la session, par exemple après que vous avez installé l’agent vous-même.
• Si l’agent est déjà installé en dehors du PATH, saisissez son chemin complet dans « Chemin de l’exécutable » et choisissez « Utiliser ce chemin », ou utilisez « Parcourir… ».
• « Documentation » ouvre la documentation d’installation de l’agent ; « Je m’en occupe » ferme la carte.

Après l’installation, chaque agent nécessite toujours sa propre connexion ou sa propre clé d’API.

8. Le panneau Infos : utilisation, contexte et ressources

Lorsqu’une session d’agent est ouverte, l’onglet Infos du panneau de droite affiche les sections suivantes :

• Agent : le type d’agent, le nom de la session, le répertoire de travail, la branche Git, l’heure de démarrage et la durée d’exécution. Pour les sessions Kiro, cette section propose aussi un lien vers une vue en lecture seule de l’historique de la conversation.
• Utilisation (Claude, Codex, Grok Build) : la consommation du quota du compte, par exemple sur les fenêtres de cinq heures et de sept jours, avec leurs heures de réinitialisation. Le bouton ↻ actualise immédiatement les valeurs. L’actualisation automatique et son intervalle se règlent dans Paramètres ▸ Comportement (« Usage auto-refresh », « Usage refresh »). En cas d’échec d’une actualisation, les dernières valeurs restent affichées avec la mention « obsolète ».
• Ce tour (Claude, Codex, Grok Build, OpenCode, Pi, OMP, Kiro) : le modèle, le taux de remplissage de la fenêtre de contexte, ainsi que le nombre de jetons et les outils du tour en cours.
• Ressources : l’utilisation du processeur et de la mémoire par les processus de la session ; l’option « système » ajoute les chiffres de l’ensemble de l’ordinateur.

9. Transcriptions, export et archivage

• Clic droit → « Exporter la session… » (Claude et Codex, dès qu’une conversation existe) écrit l’intégralité de la conversation dans un fichier Markdown, y compris le raisonnement et chaque appel d’outil avec ses entrées et son résultat.
• « Organiser dans la base de connaissances des sessions », dans le menu de la session, charge un agent d’extraire de la conversation les connaissances réutilisables ; voir Base de connaissances des sessions.
• Les sessions archivées peuvent être consultées dans la vue « Sessions archivées » de la base de connaissances. Les conversations de Claude, Codex, OpenCode, Pi, OMP, Grok Build et Kiro s’affichent sous forme de messages ; pour les autres agents, l’enregistrement du terminal est affiché s’il existe. La restauration d’une session archivée conserve son identifiant de conversation ; la session reprend donc normalement. Voir Gestion de l’interface et des sessions, §8.

10. Autres comportements

• Noms automatiques : une session que vous n’avez pas nommée prend le nom de votre premier message.
• Changements de thème : le passage du thème clair au thème sombre, ou l’inverse, met à jour les sessions Claude en cours d’exécution dans la vue terminal sans redémarrage.
• Vela Skills : Paramètres ▸ Général ▸ « Vela Skills » installe pour Claude Code et Codex des compétences qui démarrent des sessions enfants, ouvrent des fichiers, et lisent d’autres sessions ou leur envoient des messages ; voir Commandes de session.
• Windows : Claude Code et Codex sont entièrement pris en charge (ils s’exécutent dans PowerShell) ; les autres agents sont proposés sans garantie de fonctionnement complet.