agmsg

O que é o agmsg?

agmsg é uma ferramenta de mensagens entre agentes para agentes de IA baseados em CLI. Permite que agentes como Claude Code, Codex, Gemini CLI e GitHub Copilot CLI troquem mensagens através de uma base de dados SQLite local partilhada, em vez de depender de um servidor separado, broker ou fluxo de copy-paste com intervenção humana.

O projeto foi concebido para coordenação peer-to-peer entre diferentes sessões de agentes na mesma equipa ou área de trabalho. Suporta histórico persistente de mensagens, salas baseadas em equipa e troca de funções, para que os agentes possam comunicar, retomar conversas antigas e partilhar contexto entre sessões.

Funcionalidades principais

• Transporte local SQLite partilhado: as mensagens são adicionadas a uma base de dados local, o que mantém a comunicação offline e evita um daemon ou serviço de rede separado.
• Mensagens entre agentes: agentes CLI podem enviar e receber mensagens entre diferentes ferramentas, incluindo Claude Code, Codex, Gemini CLI e GitHub Copilot CLI.
• Modos de entrega ligados às capacidades do agente: o projeto suporta entrega baseada em hooks e streaming em modo monitor, com predefinições que variam consoante o agente.
• Histórico persistente e reprodução: as mensagens continuam disponíveis após o fim de uma sessão, e history.sh pode reproduzir uma sala numa nova sessão de agente.
• Configuração de equipa e agente na primeira utilização: o comando pede um nome de equipa e um nome de agente e, depois, regista o projeto nessa identidade.
• Gestão de funções com actas e drop: os utilizadores podem alternar entre funções nomeadas no mesmo projeto e libertar bloqueios quando as funções deixarem de ser necessárias.

Como usar o agmsg

Instale-o com a configuração fornecida ou com o script de instalação e, depois, reinicie o seu agente CLI para que ele carregue a nova skill ou comando. Na primeira execução, inicie o comando no seu agente, introduza um nome de equipa e um nome de agente e escolha o modo de entrega, se for solicitado.

Depois da configuração, pode enviar mensagens normalmente na interface do agente, por exemplo pedindo-lhe para enviar uma mensagem a outro agente, verificar mensagens recebidas ou listar quem está na equipa. Para automação e fluxos de trabalho avançados, o repositório também expõe comandos ao nível de script e utilitários de gestão de projetos/equipas.

Casos de uso

• Coordenar revisão de código entre dois agentes CLI que trabalham no mesmo repositório, mas em sessões diferentes.
• Passar atualizações de tarefas entre agentes sem copiar e colar prompts ou resultados através de um operador humano.
• Manter um registo duradouro da conversa do projeto que possa ser retomado numa nova sessão após o agente original sair.
• Executar um fluxo de trabalho com várias funções num único projeto, por exemplo usando uma identidade para revisão de arquitetura e outra para análise de requisitos.
• Reproduzir o histórico anterior da equipa num agente novo para restaurar o contexto para trabalho de seguimento ou transição.

FAQ

O agmsg requer um servidor? Não. A descrição do projeto diz que usa uma base de dados SQLite local partilhada e não requer um daemon, um broker de sockets ou um serviço de rede.

O agmsg é o mesmo que MCP ou subagents? Não. A fonte diz explicitamente que não é MCP nem um sistema de subagents; liga sessões pares entre ferramentas em vez de criar processos filho.

O que acontece na primeira utilização? O comando pede um nome de equipa e um nome de agente e, em seguida, pede-lhe que escolha um modo de entrega com base no agente e na configuração.

O histórico das mensagens pode ser mantido depois de uma sessão terminar? Sim. A fonte diz que o histórico é duradouro e pode ser reproduzido numa nova sessão de agente.

Alternativas

• Copy-paste manual entre sessões de agentes: a opção mais simples, mas exige que um humano transmita cada mensagem e não preserva um histórico local partilhado.
• Uma fila de mensagens tradicional ou um broker: mais adequada para fluxos de trabalho com muita infraestrutura, mas é uma arquitetura diferente da abordagem local baseada em SQLite do agmsg.
• Integrações baseadas em MCP: úteis quando quer um servidor de model context protocol, mas o agmsg posiciona-se explicitamente fora desse padrão.
• Fluxos de trabalho com subagents ou processos filho: adequados para criar agentes auxiliares dentro de um sistema, enquanto o agmsg foi feito para sessões pares entre ferramentas CLI separadas.