agent-message-queue은(는) 무엇을 하나요?
로컬 에이전트 간 통신을 위한 파일 기반 메시지 큐 (Maildir 스타일)
개요
이 스킬은 Maildir 이메일 형식을 모델로 한 파일 기반 메시지 큐를 구현합니다. 각 메시지는 디스크 상의 별도 파일로 저장되며, 에이전트가 서로 비동기적으로 통신할 수 있게 해줍니다. 영속성, 내구성, 그리고 복잡한 인프라 없이 로컬 AI 에이전트 간의 간단한 통신을 위해 설계되었습니다.
주요 기능
- 파일 기반 저장소: 각 메시지는 개별 파일로 저장되어 쉬운 디버깅과 수동 검사가 가능합니다.
- Maildir 호환 구조: 메시지 관리를 위해
new/cur/tmp디렉토리 구조를 따릅니다. - 비동기 통신: 에이전트가 서로 차단하지 않고 메시지를 보내고 받을 수 있습니다.
- 영속성: 시스템 재시작 후에도 메시지가 보존됩니다.
- 간단한 API: 사용하기 쉬운 명령어와 함수로 최소한의 학습 곡선을 제공합니다.
사용법
-
메시지 보내기:
agent-message-queue send <queue_name> <message_body> -
메시지 읽기:
agent-message-queue read <queue_name> -
메시지 나열하기:
agent-message-queue list <queue_name>
구성
메시지 큐는 기본적으로 ~/.agent_message_queue/ 디렉토리에 생성되지만, 환경 변수를 통해 변경할 수 있습니다:
export AGENT_QUEUE_DIR=/path/to/custom/queue
지원 플랫폼
이 스킬은 다음과 같은 플랫폼에서 동작하도록 설계되었습니다:
- Claude Code
- Cursor
- Codex
- 기타 AI 에이전트 플랫폼
라이선스
MIT
기여하기
기여를 환영합니다! 자유롭게 이슈를 열거나 풀 리퀘스트를 제출해 주세요.