agmsg

Was ist agmsg?

agmsg ist ein Cross-Agent-Messaging-Tool für CLI-basierte KI-Agenten. Es ermöglicht Agenten wie Claude Code, Codex, Gemini CLI und GitHub Copilot CLI, Nachrichten über eine gemeinsame lokale SQLite-Datenbank auszutauschen, statt auf einen separaten Server, Broker oder einen manuellen Copy-Paste-Workflow angewiesen zu sein.

Das Projekt ist für die Peer-to-Peer-Koordination zwischen verschiedenen Agent-Sitzungen im selben Team oder Workspace ausgelegt. Es unterstützt dauerhaften Nachrichtenverlauf, teambasierte Rooms und Rollenwechsel, damit Agenten kommunizieren, alte Gespräche fortsetzen und Kontext über Sitzungen hinweg teilen können.

Hauptfunktionen

• Gemeinsamer lokaler SQLite-Transport: Nachrichten werden an eine lokale Datenbank angehängt, was die Kommunikation offline hält und einen separaten Daemon oder Network-Service vermeidet.
• Cross-Agent-Messaging: CLI-Agenten können über verschiedene Tools hinweg Nachrichten senden und empfangen, darunter Claude Code, Codex, Gemini CLI und GitHub Copilot CLI.
• Zustellmodi abhängig von den Agent-Fähigkeiten: Das Projekt unterstützt Hook-basierte Zustellung und Monitor-Mode-Streaming, mit je nach Agent unterschiedlichen Standardwerten.
• Dauerhafter Verlauf und Replay: Nachrichten bleiben auch nach dem Ende einer Sitzung verfügbar, und history.sh kann einen Room in eine neue Agent-Sitzung abspielen.
• Team- und Agent-Setup beim ersten Einsatz: Der Befehl fragt nach einem Teamnamen und einem Agentennamen und registriert dann das Projekt für diese Identität.
• Rollenverwaltung mit actas und drop: Nutzer können innerhalb desselben Projekts zwischen benannten Rollen wechseln und Locks freigeben, wenn Rollen nicht mehr benötigt werden.

So verwenden Sie agmsg

Installieren Sie es mit dem bereitgestellten Setup oder Installationsskript und starten Sie anschließend Ihren CLI-Agenten neu, damit er die neue Skill oder den neuen Befehl übernimmt. Beim ersten Lauf starten Sie den Befehl in Ihrem Agenten, geben einen Teamnamen und einen Agentennamen ein und wählen bei Bedarf den Zustellmodus aus.

Nach dem Setup können Sie im Agenten-Interface ganz natürlich Nachrichten senden, etwa um ihn zu bitten, einen anderen Agenten anzuschreiben, eingehende Nachrichten zu prüfen oder anzuzeigen, wer im Team ist. Für Automatisierung und fortgeschrittene Workflows stellt das Repository außerdem Befehle auf Skript-Ebene sowie Projekt-/Team-Verwaltungswerkzeuge bereit.

Anwendungsfälle

• Abstimmung von Code-Reviews zwischen zwei CLI-Agenten, die im selben Repository, aber in unterschiedlichen Sitzungen arbeiten.
• Weitergabe von Aufgaben-Updates zwischen Agenten, ohne Prompts oder Ergebnisse per Hand zu kopieren.
• Pflege eines dauerhaften Projektgesprächsprotokolls, das in einer neuen Sitzung nach dem Ende des ursprünglichen Agenten fortgesetzt werden kann.
• Ausführen eines Multi-Rollen-Workflows in einem Projekt, etwa mit einer Identität für Architektur-Review und einer anderen für Anforderungsanalyse.
• Wiederholen des früheren Teamverlaufs in einem frischen Agenten, um Kontext für Folgearbeit oder Übergaben wiederherzustellen.

FAQ

Benötigt agmsg einen Server? Nein. In der Projektbeschreibung heißt es, dass es eine gemeinsame lokale SQLite-Datenbank verwendet und keinen Daemon, Socket-Broker oder Network-Service benötigt.

Ist agmsg dasselbe wie MCP oder Subagents? Nein. Die Quelle sagt ausdrücklich, dass es weder MCP noch ein Subagent-System ist; es verbindet Peer-Sitzungen über Tools hinweg, statt Child-Processes zu starten.

Was passiert beim ersten Einsatz? Der Befehl fragt nach einem Teamnamen und einem Agentennamen und lässt Sie dann je nach Agent und Setup einen Zustellmodus auswählen.

Kann der Nachrichtenverlauf nach dem Ende einer Sitzung erhalten bleiben? Ja. Laut Quelle ist der Verlauf dauerhaft und kann in eine neue Agent-Sitzung wieder abgespielt werden.

Alternativen

• Manuelles Copy-Paste zwischen Agent-Sitzungen: einfachster Fallback, erfordert aber, dass ein Mensch jede Nachricht weiterleitet, und bewahrt keinen gemeinsamen lokalen Verlauf.
• Eine klassische Message Queue oder ein Broker: besser geeignet für infrastrukturlastige Workflows, aber eine andere Architektur als agmsgs dateibasierter lokaler SQLite-Ansatz.
• MCP-basierte Integrationen: nützlich, wenn Sie einen Model Context Protocol Server चाहते, aber agmsg positioniert sich ausdrücklich außerhalb dieses Musters.
• Subagent- oder Child-Process-Workflows: geeignet, wenn Helper-Agenten innerhalb eines Systems gestartet werden sollen, während agmsg für Peer-Sitzungen über separate CLI-Tools hinweg gebaut ist.