Hermes Agent : créer et utiliser un Kanban

Tu demandes à Hermes de comparer quelques solutions. Il rassemble des informations, prépare une proposition, puis la relit. Quand tu reviens plus tard, tu veux savoir où en est le travail et retrouver le document utile sans parcourir toute la conversation.

Le Kanban sert à garder ce fil. C’est un tableau de tâches : chaque carte décrit une étape du travail et conserve son suivi. Tu peux demander à Hermes de consulter ces cartes pour t’expliquer ce qui avance, ce qui attend et ce qui est prêt à lire.

Un premier tableau Kanban accessible, une petite tâche exécutée, puis une mission organisée en trois cartes. Tu sauras demander un bilan et retrouver le résultat.

Hermes est installé et répond déjà à tes demandes. Tu n’as besoin ni d’un Kanban existant ni de plusieurs profils. Nous partons du profil de base, default, sur la machine où Hermes tourne. Sous Windows, ouvre ton terminal Ubuntu/WSL pour les commandes qui suivent.

Nous allons préparer une fiche pour choisir un outil qui transforme de l’audio en texte sur ton ordinateur. Le scénario et les échanges sont illustratifs : aucune comparaison ni transcription n’a été exécutée pour ce guide. Tu peux reprendre la démarche pour un autre choix ou un petit projet.

1. Créer et ouvrir ton tableau

Un tableau rassemble les tâches. Une carte décrit une tâche. Un profil fournit à Hermes ses réglages, son modèle et ses outils. Pour commencer, le même profil peut prendre en charge les étapes successives ; tu n’as pas besoin de constituer une équipe de spécialistes.

Initialiser le premier Kanban

Dans le terminal où la commande hermes fonctionne, saisis :

hermes kanban init
hermes kanban boards list

La première commande initialise le stockage du Kanban. La seconde liste les tableaux : tu dois retrouver celui nommé default. C’est celui que nous utiliserons. Si tu as déjà des tableaux, ces commandes ne te demandent pas de les supprimer.

Pour choisir explicitement ce tableau :

hermes kanban boards switch default

default désigne ici le tableau. Le profil de base porte aussi ce nom, mais ce sont deux choses distinctes : le tableau contient les cartes ; le profil effectue le travail.

Voir les cartes dans le navigateur

Lance ensuite :

hermes dashboard

Ouvre l’adresse locale affichée par Hermes, généralement http://127.0.0.1:9119, puis la rubrique Kanban. Tu dois voir le tableau et ses colonnes, même s’il est encore vide. Laisse ce terminal ouvert si le tableau de bord y fonctionne.

Si Hermes signale un composant manquant, suis l’indication d’installation donnée par ta version, puis relance le tableau de bord. Si la commande elle-même est inconnue, vérifie hermes --help et ta version avant de poursuivre : cette procédure suit la documentation actuelle.

Sur un VPS : l’adresse 127.0.0.1 désigne le serveur, pas ton téléphone ou ton PC. Depuis le terminal de ton ordinateur, tu peux ouvrir un tunnel SSH :

ssh -L 9119:127.0.0.1:9119 utilisateur@serveur

Remplace utilisateur@serveur par ton accès SSH habituel et laisse la connexion ouverte. Ouvre ensuite http://127.0.0.1:9119 sur cet ordinateur. Le tableau de bord doit rester lancé sur le VPS ; inutile d’exposer son port publiquement pour cet essai.

2. Donner à Hermes les outils du Kanban

Le tableau est visible. Il faut maintenant permettre au profil avec lequel tu dialogues de lire et créer les cartes.

Dans un autre terminal, active les outils Kanban pour le profil de base :

hermes -p default tools enable kanban

Puis ouvre une nouvelle conversation, pour qu’elle charge les outils ajoutés :

hermes -p default chat

Tu peux lui demander :

Avec tes outils Kanban, consulte le tableau default et indique les cartes présentes, sans en créer pour l’instant. Si tu n’as pas ces outils, dis-le-moi.

Hermes consulte réellement le tableau et t’en donne le contenu, éventuellement vide. Une réponse qui décrit seulement le principe du Kanban ne valide pas cette étape.

Pour le parcours de ce guide, reste dans cette conversation de terminal. Si tu veux ensuite piloter le même profil depuis Telegram, l’autorisation se règle aussi pour cette plateforme :

hermes -p default tools enable kanban --platform telegram

Il faudra là encore une nouvelle conversation. Si tu utilises un profil personnel plutôt que default, remplace ce nom dans les commandes ; garde le même profil tout au long de ton premier essai.

3. Lancer une première tâche très courte

Une carte peut exister sans que personne ne la traite. Le dispatcher est le mécanisme qui prend les tâches prêtes et lance Hermes pour les effectuer. Dans le fonctionnement actuel documenté, il est intégré au gateway, le service Hermes qui reste actif pendant le travail.

Vérifier le service qui lance les tâches

Dans un autre terminal, regarde d’abord son état :

hermes -p default gateway status

S’il fonctionne déjà pour ce profil, garde cette instance. Sinon, pour ce premier essai — notamment sous WSL — lance-le au premier plan :

hermes -p default gateway run

Laisse ce terminal ouvert. Si tu disposes déjà d’un service installé sous Linux ou macOS, hermes -p default gateway start permet de le démarrer en arrière-plan. Choisis le mode qui correspond à ton installation ; ne lance pas deux instances pour le même profil.

Le tableau de bord sert à voir le travail, le gateway permet son lancement et la conversation te sert à le piloter. Ces trois rôles expliquent pourquoi un tableau visible peut encore être vide ou inactif.

Créer une carte et lire son résultat

Dans ta nouvelle conversation avec Hermes, demande :

Dans le tableau default, crée une seule tâche intitulée « Premier essai Kanban », attribuée au profil default. Son travail : proposer trois titres courts pour une fiche sur la transcription audio locale. Aucun accès web ni modification de fichier n’est nécessaire. Fais enregistrer les trois titres dans le résultat de la tâche. Donne-moi sa référence.

La tâche est volontairement minuscule : elle permet de vérifier le circuit sans dépendre d’une recherche ou d’un logiciel de transcription. Elle utilise néanmoins le modèle configuré pour ce profil, avec son éventuel coût d’API.

Retrouve la carte dans le tableau. Elle peut passer par Ready (prête), In progress (en cours), puis Done (terminée). Une tâche rapide peut finir avant que tu voies chaque transition.

Ouvre la carte : tu dois retrouver les trois titres dans son résultat, pas seulement une colonne qui a changé. Tu peux également demander à Hermes de relire cette carte et de te montrer le résultat.

Si elle reste en attente, utilise cette commande de diagnostic :

hermes kanban diagnostics

Vérifie le profil attribué, son accès au modèle et l’état du gateway. Une carte non attribuée ou un service arrêté ne se corrige pas en recréant la même tâche. Si Hermes signale une erreur, traite ce point avant de lancer la mission suivante.

4. Définir le résultat de ta vraie mission

Ton premier circuit fonctionne : une carte a été créée, exécutée et son résultat est lisible. Tu peux maintenant passer à la fiche de choix.

Pour cette mission, on veut une fiche courte qui aide à choisir une solution à essayer. On ne demande encore ni installation ni traitement d’un enregistrement.

Prenons un besoin facile à décrire : transcrire de courts mémos en français, avec une interface graphique. Il faudra aussi préciser ton système, le matériel que tu connais et tes éventuelles contraintes de confidentialité.

Cette fois, Hermes doit pouvoir consulter des sources et conserver un document. Dans le terminal, ouvre hermes -p default tools pour vérifier les outils de recherche, de consultation et de fichiers disponibles pour ce profil. Si tu modifies cette sélection, ouvre une nouvelle conversation. Demande à Hermes de signaler un accès manquant avant de présenter la recherche comme faite.

Dans la conversation ainsi préparée, précise ton besoin :

Je veux choisir un outil pour transcrire de courts mémos en français sur mon ordinateur, avec une interface graphique. Le résultat visé sera une fiche courte avec les options pertinentes, leurs limites et les sources utiles. Nous allons organiser ce travail dans le Kanban. Pour le moment, demande-moi seulement les informations manquantes qui changeraient le choix, sans lancer la recherche ni la rédaction. La mission restera sans installation ni traitement d’audio.

Le résultat attendu devient concret : tu dois pouvoir lire la fiche et comprendre quelle option essayer, pourquoi et ce qui reste à vérifier. Une liste de noms de logiciels ne suffit pas.

Ici, « sur mon ordinateur » concerne l’outil de transcription recherché. Cela ne signifie pas que le modèle utilisé par Hermes et ses recherches fonctionnent eux aussi localement. Aucun enregistrement privé n’est nécessaire pour préparer cette fiche.

5. Organiser le travail en trois cartes

Une carte représente une étape assez importante pour laisser un résultat à la suivante. Dans notre exemple, trois cartes suffisent :

Rassembler le besoin et les sources

Elle conserve tes contraintes, les liens utiles et les questions encore ouvertes. La personne ou le profil qui prépare la fiche doit pouvoir partir de ce dossier sans te redemander tout le contexte.

À retrouver

Un résumé de ton besoin et des sources consultables.

Préparer la fiche de choix

Elle utilise le dossier précédent pour rapprocher les options de tes contraintes et expliquer leurs limites.

À retrouver

Une proposition de fiche, avec les raisons du choix et les points à essayer.

Relire et corriger la fiche

Elle vérifie que la proposition respecte ton besoin et que les sources soutiennent les affirmations importantes.

À retrouver

La fiche relue, les corrections éventuelles et les questions qui restent ouvertes.

Ces cartes se suivent. La rédaction a besoin du dossier ; la relecture a besoin de la fiche. Ce lien s’appelle une dépendance : la carte suivante attend que la précédente soit terminée pour pouvoir être lancée. Pense aussi à conserver le document utile avec la carte ; le lien seul ne remplace pas ce résultat.

Pourquoi la relecture attend

Exemple illustratif · la fiche est en cours de rédaction.

La carte 1 est terminée : son dossier sert à rédiger la fiche dans la carte 2. La carte 3 attend que la carte 2 soit terminée ; elle aura besoin de la fiche pour la relire. Cette attente fait partie du déroulement prévu.

Une fois ton besoin précisé, demande à Hermes :

Dans le tableau default, utilise tes outils Kanban pour organiser cette mission en trois étapes : rassembler le besoin et les sources, préparer la fiche, puis la relire. Attribue les trois tâches au profil default et déclare les dépendances dès leur création : la deuxième attend la première, la troisième attend la deuxième. Conserve les documents utiles avec les cartes. Donne-moi le tableau utilisé et les références des cartes créées. Si un outil, un profil ou un accès nécessaire manque, indique lequel.

Pour ce premier parcours, les trois étapes utilisent le même profil. La relecture constitue un second passage sur le document, pas un avis indépendant obtenu auprès d’un autre modèle. Tu pourras ensuite attribuer les rôles à des profils distincts si ton usage le justifie.

Tu demandes à Hermes de créer de vraies tâches avec ses outils ; tu n’as pas à écrire toi-même leurs appels techniques.

Après sa réponse, tu dois pouvoir retrouver les trois cartes dans le tableau annoncé, avec leur rôle et leurs liens. Une simple description de ce qu’il ferait ne suffit pas. Garde leurs références : elles serviront à retrouver la mission dans une autre conversation.

Ce découpage est une méthode proposée pour cet exemple, pas une organisation obligatoire pour toutes les missions.

6. Demander un bilan utile

La mission est lancée. Tu n’as pas besoin de surveiller chaque changement de colonne. Demande plutôt :

Relis les cartes et leurs documents. Où en est ma fiche ? Qu’est-ce qui est prêt à lire, qu’est-ce qui attend et ai-je une décision à prendre ?

Voici le type de réponse utile dans notre scénario :

Le dossier du besoin et des sources est prêt dans la première carte. La fiche est en cours de rédaction. Sa relecture attend cette proposition ; tu n’as rien à décider pour le moment. Tu peux déjà consulter le dossier joint à la première carte.

Tu comprends à la fois où en est le travail et ce que tu peux faire maintenant. « Terminé, en cours, en attente » serait moins utile sans cette explication.

Une attente n’est pas forcément un problème : la troisième carte attend normalement la deuxième. Si Hermes signale un blocage, demande-lui quelle information ou quel accès manque et quelle étape cela empêche. Il doit s’appuyer sur l’état des cartes, pas supposer que tout a avancé depuis votre dernier échange.

7. Ajuster la demande sans perdre le travail utile

Tu peux préciser ton besoin en cours de route. Supposons que tu ajoutes une exigence de fonctionnement sans connexion pendant la transcription :

Ajoute cette contrainte : la transcription devra fonctionner sans connexion. Vérifie ce que cela change dans le travail en cours, conserve les recherches encore utiles et reporte cette exigence dans les cartes concernées.

Hermes doit alors examiner ce qui existe avant d’adapter la fiche. Les sources déjà trouvées peuvent rester utiles ; certaines options demanderont une vérification supplémentaire.

Ce que tu dois constater : la nouvelle contrainte figure dans le dossier et dans la fiche, avec les inconnues éventuelles. Elle ne doit pas rester seulement dans le dialogue. Par exemple, un logiciel peut nécessiter un téléchargement initial tout en transcrivant ensuite hors ligne : la fiche doit expliquer ce qui est documenté pour l’option envisagée.

Si une décision indispensable manque, Hermes te la demande. Tu n’as pas à revalider chaque petite étape pour que la mission continue.

8. Lire la fiche et demander une correction précise

Quand Hermes annonce la fiche prête, fais-toi donner le document et ouvre-le. Tu dois pouvoir répondre à trois questions :

Les options correspondent-elles à ton besoin ?
Comprends-tu les raisons de la recommandation ?
Les limites et les points à essayer sont-ils visibles ?

Imaginons que la fiche affirme « c’est l’outil le plus rapide » sans comparaison pertinente. La correction consiste à retirer cette conclusion ou à expliquer qu’elle reste à tester.

Tu peux demander :

La fiche présente cet outil comme le plus rapide, mais je ne vois pas de mesure qui le justifie. Vérifie la source et corrige cette affirmation si elle n’est pas étayée. Donne-moi la version corrigée et résume le changement.

La correction doit apparaître dans le document lui-même. Un commentaire « à vérifier » ne suffit pas si la fiche conserve l’affirmation.

Une carte déclarée terminée — done dans l’interface — indique un état de suivi. Elle ne remplace pas ta lecture. Dans notre exemple, la fiche aide à choisir une option à essayer ; sans essai audio, elle ne peut pas désigner la meilleure transcription pour tes enregistrements.

9. Retrouver la mission plus tard

Avant de quitter, demande que la fiche finale soit attachée à sa carte et que Hermes vérifie qu’elle s’ouvre. Un fichier laissé seulement dans un espace temporaire peut disparaître lors du nettoyage ; citer son chemin dans une réponse ne suffit pas à le conserver.

À ton retour, tu peux dire :

Reprends la mission [référence] dans le tableau [nom]. Relis les cartes et la dernière fiche jointe, puis rappelle-moi ce qui est terminé et ce qui reste à décider. Ne recrée pas la mission.

Les cartes et leurs documents donnent un point de départ au nouvel échange, sous réserve que leur stockage et leurs accès aient été conservés. Cela ne garantit pas que le travail a continué sans interruption.

Si une tâche s’est arrêtée ou si le résultat d’une action est incertain, passe au compagnon sur la reprise de mission. Il explique comment vérifier ce qui existe avant de relancer.

Quand utiliser ce suivi

Le Kanban devient utile quand une mission comporte plusieurs étapes, transmet un résultat d’un profil à un autre ou doit être retrouvée plus tard. Son intérêt se voit simplement : tu sais où en est le travail et tu retrouves le document qui permet de décider.

Pour une question rapide, une conversation suffit. Pour deux recherches indépendantes à rapprocher dans le même échange, regarde plutôt le compagnon sur la délégation.

Pour ton premier essai, garde une mission modeste et un résultat facile à reconnaître. Si tu peux demander un bilan, ouvrir la fiche et reprendre le suivi sans raconter toute l’histoire, le tableau t’apporte déjà quelque chose.

Sources et lectures utiles

Documentation officielle du Kanban : outils, accès, dépendances, transmissions et pièces jointes.
Tutoriel officiel Kanban : mise en route et exemples de travail entre profils.
Commandes officielles Hermes : profils, lancement du gateway et distinction entre service et premier plan.
Tableau de bord Hermes : ouverture locale et accès distant.
Sommaire Hermes Agent : retrouver les étapes du parcours et les autres compagnons.

Révision pédagogique du 8 novembre 2026. Repères sur le fonctionnement du Kanban recoupés avec les documentations officielles ci-dessus ; scénario non exécuté.