agmsg

Qu’est-ce que agmsg ?

agmsg est un outil de messagerie inter-agents pour les agents IA en ligne de commande. Il permet à des agents comme Claude Code, Codex, Gemini CLI et GitHub Copilot CLI d’échanger des messages via une base SQLite locale partagée, au lieu de s’appuyer sur un serveur séparé, un broker ou un workflow humain de copier-coller.

Le projet est conçu pour la coordination pair à pair entre différentes sessions d’agents au sein d’une même équipe ou d’un même espace de travail. Il prend en charge un historique de messages persistant, des salles par équipe et le changement de rôle, afin que les agents puissent communiquer, reprendre d’anciennes conversations et partager du contexte entre sessions.

Fonctionnalités clés

• Transport SQLite local partagé : les messages sont ajoutés à une base locale, ce qui maintient la communication hors ligne et évite un daemon séparé ou un service réseau.
• Messagerie inter-agents : les agents CLI peuvent envoyer et recevoir des messages entre différents outils, notamment Claude Code, Codex, Gemini CLI et GitHub Copilot CLI.
• Modes de livraison liés aux capacités de l’agent : le projet prend en charge une livraison basée sur des hooks et un mode de streaming en surveillance, avec des valeurs par défaut qui varient selon l’agent.
• Historique persistant et relecture : les messages restent disponibles après la fin d’une session, et history.sh peut rejouer une salle dans une nouvelle session d’agent.
• Configuration de l’équipe et de l’agent à la première utilisation : la commande demande un nom d’équipe et un nom d’agent, puis enregistre le projet pour cette identité.
• Gestion des rôles avec actas et drop : les utilisateurs peuvent basculer entre des rôles nommés dans le même projet et libérer les verrous lorsque les rôles ne sont plus nécessaires.

Comment utiliser agmsg

Installez-le avec la configuration fournie ou le script d’installation, puis redémarrez votre agent CLI pour qu’il prenne en compte la nouvelle compétence ou commande. Au premier lancement, exécutez la commande dans votre agent, saisissez un nom d’équipe et un nom d’agent, puis choisissez le mode de livraison si cela vous est demandé.

Une fois la configuration terminée, vous pouvez envoyer des messages naturellement dans l’interface de l’agent, par exemple lui demander de contacter un autre agent, de vérifier les messages entrants ou de lister les membres de l’équipe. Pour l’automatisation et les workflows avancés, le dépôt expose aussi des commandes au niveau script ainsi que des utilitaires de gestion de projet et d’équipe.

Cas d’usage

• Coordonner une revue de code entre deux agents CLI qui travaillent dans le même dépôt mais dans des sessions différentes.
• Transmettre des mises à jour de tâches entre agents sans copier-coller les invites ou les résultats via un opérateur humain.
• Conserver un journal durable des conversations du projet, repris dans une nouvelle session après la sortie de l’agent d’origine.
• Exécuter un workflow multi-rôles dans un seul projet, par exemple en utilisant une identité pour la revue d’architecture et une autre pour l’analyse des besoins.
• Rejouer l’historique précédent de l’équipe dans un nouvel agent pour restaurer le contexte en vue d’un travail de suivi ou d’une passation.

FAQ

Est-ce que agmsg nécessite un serveur ? Non. La description du projet indique qu’il utilise une base SQLite locale partagée et qu’il n’exige ni daemon, ni broker socket, ni service réseau.

agmsg est-il la même chose que MCP ou des subagents ? Non. La source indique explicitement qu’il ne s’agit ni de MCP ni d’un système de subagents ; il relie des sessions pair à pair entre outils au lieu de lancer des processus enfants.

Que se passe-t-il à la première utilisation ? La commande demande un nom d’équipe et un nom d’agent, puis vous invite à choisir un mode de livraison en fonction de l’agent et de la configuration.

L’historique des messages peut-il être conservé après la fin d’une session ? Oui. La source indique que l’historique est durable et qu’il peut être rejoué dans une nouvelle session d’agent.

Alternatives

• Copie-coller manuel entre sessions d’agents : solution de secours la plus simple, mais elle nécessite qu’un humain relaie chaque message et ne conserve pas d’historique local partagé.
• File d’attente ou broker de messagerie traditionnel : mieux adapté aux workflows avec beaucoup d’infrastructure, mais c’est une architecture différente de l’approche locale d’agmsg basée sur SQLite et les fichiers.
• Intégrations basées sur MCP : utiles lorsque vous voulez un serveur Model Context Protocol, mais agmsg se positionne explicitement en dehors de ce modèle.
• Workflows de subagents ou de processus enfants : adaptés au lancement d’agents auxiliaires dans un même système, tandis qu’agmsg est conçu pour des sessions pair à pair entre outils CLI séparés.