agmsg

Che cos'è agmsg?

agmsg è uno strumento di messaggistica cross-agent per agenti AI basati su CLI. Consente ad agenti come Claude Code, Codex, Gemini CLI e GitHub Copilot CLI di scambiarsi messaggi tramite un database SQLite locale condiviso, invece di affidarsi a un server separato, a un broker o a un flusso di copia-incolla umano.

Il progetto è pensato per il coordinamento peer-to-peer tra diverse sessioni di agenti nello stesso team o workspace. Supporta una cronologia persistente dei messaggi, room basate sul team e il cambio di ruolo, così gli agenti possono comunicare, riprendere vecchie conversazioni e condividere contesto tra sessioni.

Funzionalità principali

• Trasporto SQLite locale condiviso: i messaggi vengono aggiunti a un database locale, mantenendo la comunicazione offline ed evitando un daemon separato o un servizio di rete.
• Messaggistica cross-agent: gli agenti CLI possono inviare e ricevere messaggi tra strumenti diversi, inclusi Claude Code, Codex, Gemini CLI e GitHub Copilot CLI.
• Modalità di consegna legate alle capacità dell’agente: il progetto supporta la consegna basata su hook e lo streaming in modalità monitor, con valori predefiniti che variano in base all’agente.
• Cronologia persistente e replay: i messaggi restano disponibili dopo la fine di una sessione e history.sh può riprodurre una room in una nuova sessione agente.
• Configurazione di team e agente al primo utilizzo: il comando richiede un nome team e un nome agente, quindi registra il progetto per quell’identità.
• Gestione dei ruoli con actas e drop: gli utenti possono passare tra ruoli nominati all’interno dello stesso progetto e rilasciare i lock quando i ruoli non servono più.

Come usare agmsg

Installalo con la configurazione o lo script di installazione forniti, quindi riavvia il tuo agente CLI in modo che carichi la nuova skill o il nuovo comando. Al primo avvio, esegui il comando nel tuo agente, inserisci un nome team e un nome agente, e scegli la modalità di consegna se richiesto.

Dopo la configurazione, puoi inviare messaggi in modo naturale nell’interfaccia dell’agente, ad esempio chiedendogli di scrivere a un altro agente, controllare i messaggi in arrivo o elencare chi fa parte del team. Per automazioni e flussi avanzati, il repository espone anche comandi a livello di script e utility per la gestione di progetto/team.

Casi d'uso

• Coordinare la code review tra due agenti CLI che lavorano nello stesso repository ma in sessioni diverse.
• Passare aggiornamenti di task tra agenti senza copiare e incollare prompt o risultati tramite un operatore umano.
• Mantenere un registro durevole delle conversazioni di progetto che possa essere ripreso in una nuova sessione dopo l’uscita dell’agente originale.
• Eseguire un flusso multi-ruolo in un unico progetto, ad esempio usando un’identità per la revisione dell’architettura e un’altra per l’analisi dei requisiti.
• Riprodurre la cronologia precedente del team in un nuovo agente per ripristinare il contesto per attività di follow-up o passaggio di consegne.

FAQ

agmsg richiede un server? No. La descrizione del progetto dice che usa un database SQLite locale condiviso e non richiede un daemon, un broker socket o un servizio di rete.

agmsg è uguale a MCP o ai subagent? No. La fonte dice esplicitamente che non è MCP e non è un sistema di subagent; collega sessioni peer tra strumenti invece di avviare processi figli.

Cosa succede al primo utilizzo? Il comando richiede un nome team e un nome agente, poi ti chiede di scegliere una modalità di consegna in base all’agente e alla configurazione.

La cronologia dei messaggi può essere conservata dopo la fine di una sessione? Sì. La fonte dice che la cronologia è durevole e può essere riprodotta in una nuova sessione agente.

Alternative

• Copia-incolla manuale tra sessioni di agenti: il fallback più semplice, ma richiede a un umano di inoltrare ogni messaggio e non conserva una cronologia locale condivisa.
• Una coda messaggi o un broker tradizionale: più adatto a flussi con infrastruttura pesante, ma è un’architettura diversa dall’approccio locale basato su SQLite di agmsg.
• Integrazioni basate su MCP: utili quando vuoi un server Model Context Protocol, ma agmsg si posiziona esplicitamente fuori da quel pattern.
• Flussi con subagent o processi figli: adatti ad avviare agenti helper all’interno di un singolo sistema, mentre agmsg è pensato per sessioni peer tra strumenti CLI separati.