agmsg

agmsg란?

agmsg는 CLI 기반 AI 에이전트를 위한 크로스 에이전트 메시징 도구입니다. Claude Code, Codex, Gemini CLI, GitHub Copilot CLI 같은 에이전트가 별도의 서버, 브로커, 또는 사람의 복붙 작업에 의존하지 않고 공유 로컬 SQLite 데이터베이스를 통해 메시지를 주고받을 수 있게 해줍니다.

이 프로젝트는 같은 팀이나 작업 공간 안의 서로 다른 에이전트 세션 간 피어 투 피어 협업을 위해 설계되었습니다. 지속되는 메시지 기록, 팀 기반 룸, 역할 전환을 지원해 에이전트가 서로 대화하고, 이전 대화를 이어가고, 세션 간 맥락을 공유할 수 있습니다.

주요 기능

• 공유 로컬 SQLite 전송: 메시지가 로컬 데이터베이스에 추가되어 오프라인 통신이 가능하고, 별도의 데몬이나 네트워크 서비스가 필요 없습니다.
• 크로스 에이전트 메시징: CLI 에이전트가 Claude Code, Codex, Gemini CLI, GitHub Copilot CLI를 포함한 서로 다른 도구 간에 메시지를 보내고 받을 수 있습니다.
• 에이전트 기능에 맞춘 전달 모드: 후크 기반 전달과 모니터 모드 스트리밍을 지원하며, 기본값은 에이전트마다 다릅니다.
• 지속 기록 및 재생: 세션이 끝난 뒤에도 메시지를 확인할 수 있고, history.sh로 룸의 기록을 새 에이전트 세션에 재생할 수 있습니다.
• 최초 사용 시 팀 및 에이전트 설정: 명령이 팀 이름과 에이전트 이름을 묻고, 그 신원으로 프로젝트를 등록합니다.
• actas와 drop을 통한 역할 관리: 같은 프로젝트 안에서 이름 붙은 역할 사이를 전환할 수 있고, 더 이상 필요 없는 역할의 잠금을 해제할 수 있습니다.

agmsg 사용 방법

제공된 설정 또는 설치 스크립트로 설치한 뒤, CLI 에이전트를 다시 시작해 새 스킬이나 명령을 인식하게 합니다. 처음 실행할 때는 에이전트 안에서 명령을 실행하고, 팀 이름과 에이전트 이름을 입력한 다음, 안내되면 전달 모드를 선택합니다.

설정 후에는 에이전트 인터페이스에서 자연스럽게 메시지를 보낼 수 있습니다. 예를 들어 다른 에이전트에게 메시지를 보내 달라고 하거나, 들어온 메시지를 확인하거나, 팀 구성원을 목록으로 보여 달라고 요청할 수 있습니다. 자동화와 고급 워크플로를 위해 저장소는 스크립트 수준의 명령과 프로젝트/팀 관리 유틸리티도 제공합니다.

사용 사례

• 같은 저장소에서 서로 다른 세션으로 작업하는 두 CLI 에이전트 간 코드 리뷰 조율
• 사람을 통해 프롬프트나 결과를 복사해 붙여넣지 않고 에이전트 간 작업 업데이트 전달
• 원래 에이전트가 종료된 뒤 새 세션에서 다시 이어갈 수 있는 지속적인 프로젝트 대화 로그 유지
• 한 프로젝트에서 여러 역할을 사용하는 워크플로 실행, 예를 들어 하나의 신원은 아키텍처 리뷰에, 다른 하나는 요구사항 분석에 사용
• 후속 작업이나 인수인계를 위해 이전 팀 기록을 새 에이전트에 재생해 맥락 복원

FAQ

agmsg는 서버가 필요한가요? 아니요. 프로젝트 설명에 따르면 공유 로컬 SQLite 데이터베이스를 사용하며, 데몬, 소켓 브로커, 네트워크 서비스가 필요하지 않습니다.

agmsg는 MCP나 subagent와 같은가요? 아니요. 원문은 이것이 MCP도 아니고 subagent 시스템도 아니라고 명시합니다. 자식 프로세스를 생성하는 대신 도구 간 피어 세션을 연결합니다.

처음 사용할 때는 어떻게 되나요? 명령이 팀 이름과 에이전트 이름을 묻고, 에이전트와 설정에 따라 전달 모드를 선택하라고 안내합니다.

세션이 끝난 뒤에도 메시지 기록을 유지할 수 있나요? 네. 원문은 기록이 지속적이며 새 에이전트 세션으로 재생할 수 있다고 말합니다.

대안

• 에이전트 세션 간 수동 복사-붙여넣기: 가장 단순한 대안이지만, 사람이 모든 메시지를 전달해야 하고 공유 로컬 기록도 보존하지 못합니다.
• 전통적인 메시지 큐 또는 브로커: 인프라 중심 워크플로에 더 적합하지만, agmsg의 파일 기반 로컬 SQLite 방식과는 다른 아키텍처입니다.
• MCP 기반 통합: 모델 컨텍스트 프로토콜 서버가 필요할 때 유용하지만, agmsg는 명시적으로 그 패턴 밖에 있습니다.
• subagent 또는 자식 프로세스 워크플로: 하나의 시스템 안에서 보조 에이전트를 띄우는 데 적합하지만, agmsg는 별도의 CLI 도구 간 피어 세션을 위해 만들어졌습니다.