agmsg

¿Qué es agmsg?

agmsg es una herramienta de mensajería entre agentes para agentes de IA basados en CLI. Permite que agentes como Claude Code, Codex, Gemini CLI y GitHub Copilot CLI intercambien mensajes mediante una base de datos SQLite local compartida, en lugar de depender de un servidor aparte, un broker o un flujo de copiar y pegar manual.

El proyecto está diseñado para la coordinación entre pares a través de distintas sesiones de agentes en el mismo equipo o espacio de trabajo. Admite historial de mensajes persistente, salas basadas en equipos y cambio de rol para que los agentes puedan comunicarse, reanudar conversaciones antiguas y compartir contexto entre sesiones.

Funciones clave

• Transporte local compartido de SQLite: los mensajes se añaden a una base de datos local, lo que mantiene la comunicación sin conexión y evita un daemon o un servicio de red aparte.
• Mensajería entre agentes: los agentes CLI pueden enviar y recibir mensajes entre distintas herramientas, incluidas Claude Code, Codex, Gemini CLI y GitHub Copilot CLI.
• Modos de entrega vinculados a las capacidades del agente: el proyecto admite entrega basada en hooks y streaming en modo monitor, con valores predeterminados que varían según el agente.
• Historial persistente y reproducción: los mensajes siguen disponibles después de que termina una sesión, y history.sh puede reproducir una sala en una nueva sesión de agente.
• Configuración de equipo y agente en el primer uso: el comando solicita un nombre de equipo y un nombre de agente, y luego registra el proyecto para esa identidad.
• Gestión de roles con actas y drop: los usuarios pueden alternar entre roles nombrados dentro del mismo proyecto y liberar bloqueos cuando ya no se necesitan.

Cómo usar agmsg

Instálalo con la configuración o el script de instalación proporcionados y luego reinicia tu agente CLI para que detecte la nueva habilidad o comando. En el primer uso, inicia el comando en tu agente, introduce un nombre de equipo y un nombre de agente, y elige el modo de entrega si se te solicita.

Después de la configuración, puedes enviar mensajes de forma natural en la interfaz del agente, por ejemplo pidiéndole que escriba a otro agente, revise los mensajes entrantes o liste quién pertenece al equipo. Para automatización y flujos avanzados, el repositorio también expone comandos a nivel de script y utilidades de gestión de proyectos/equipos.

Casos de uso

• Coordinar una revisión de código entre dos agentes CLI que trabajan en el mismo repositorio pero en sesiones diferentes.
• Pasar actualizaciones de tareas entre agentes sin copiar y pegar instrucciones o resultados a través de una persona.
• Mantener un registro duradero de la conversación del proyecto que pueda reanudarse en una nueva sesión después de que salga el agente original.
• Ejecutar un flujo de trabajo con varios roles en un solo proyecto, por ejemplo usando una identidad para revisión de arquitectura y otra para análisis de requisitos.
• Reproducir el historial previo del equipo en un agente nuevo para restaurar el contexto en trabajos de seguimiento o de traspaso.

Preguntas frecuentes

¿agmsg requiere un servidor? No. La descripción del proyecto indica que usa una base de datos SQLite local compartida y no requiere un daemon, un broker de sockets ni un servicio de red.

¿agmsg es lo mismo que MCP o subagents? No. La fuente dice explícitamente que no es MCP ni un sistema de subagentes; conecta sesiones entre pares a través de herramientas en lugar de generar procesos secundarios.

¿Qué ocurre en el primer uso? El comando solicita un nombre de equipo y un nombre de agente, y luego te pide elegir un modo de entrega según el agente y la configuración.

¿Se puede conservar el historial de mensajes después de que termine una sesión? Sí. La fuente indica que el historial es duradero y puede reproducirse en una nueva sesión de agente.

Alternativas

• Copiar y pegar manualmente entre sesiones de agentes: la alternativa más simple, pero requiere que una persona retransmita cada mensaje y no conserva un historial local compartido.
• Una cola o broker de mensajes tradicional: más adecuado para flujos de trabajo con mucha infraestructura, pero es una arquitectura distinta del enfoque local de SQLite respaldado por archivos de agmsg.
• Integraciones basadas en MCP: útiles cuando quieres un servidor de Model Context Protocol, pero agmsg se posiciona explícitamente fuera de ese patrón.
• Flujos de trabajo con subagentes o procesos secundarios: apropiados para lanzar agentes auxiliares dentro de un mismo sistema, mientras que agmsg está pensado para sesiones entre pares a través de herramientas CLI separadas.