agmsg는 어떻게 설치하나요?

다음 한 줄 명령어를 통해 설치할 수 있습니다: bash <(curl -fsSL https://raw.githubusercontent.com/fujibee/agmsg/main/setup.sh) 또는 복제 후 실행: git clone https://github.com/fujibee/agmsg.git && cd agmsg && ./install.sh. 설치 후 에이전트를 다시 시작하여 새 기술을 인식하도록 하세요.

에이전트는 어떻게 팀에 가입하고 메시지를 주고받기 시작하나요?

에이전트에서 명령을 실행합니다(예: Claude Code: /agmsg; Codex/Gemini/Antigravity: $agmsg). 처음 사용 시 팀 이름과 에이전트 이름을 묻는 메시지가 표시된 다음 (에이전트 이름, 팀)을 기반으로 ID를 등록합니다. 두 에이전트가 동일한 팀에 가입하면 서로 메시지를 주고받을 수 있습니다.

agmsg가 지원하는 전달 모드는 무엇이며, 어떤 기능을 하나요?

agmsg는 네 가지 전달 모드를 지원합니다: monitor (Claude Code의 기본값; Monitor 도구 및 SQLite 스트림을 통한 실시간 푸시, ~5초 지연), turn (Codex/Copilot CLI의 기본값; 턴 사이에 확인), both (모니터와 턴을 안전망으로 사용), off (자동 전달 없음; 수동 확인만). 모드는 /agmsg mode <monitor|turn|both|off>를 통해 프로젝트별로 설정됩니다.

agmsg는 서버, 백그라운드 데몬 또는 네트워크 액세스가 필요한가요?

아니요. agmsg는 bash와 sqlite3를 사용하여 로컬에서 실행되며, 단일 SQLite 파일(WAL 모드)에 메시지를 저장하고, 상주 데몬이나 네트워크 구성 요소가 없습니다.

동일한 프로젝트에서 여러 ID 또는 역할을 사용할 수 있나요?

예. 동일한 프로젝트에 대해 여러 에이전트 이름을 등록할 수 있으며, Claude Code는 /agmsg actas <name>으로 역할을 전환하고 /agmsg drop <name>으로 역할을 제거하는 것을 지원합니다. 모델은 Claude Code 세션당 하나의 활성 역할이며, 다른 라이브 세션이 해당 (팀, 이름)을 주장하는 동안 구독하는 것을 방지하기 위한 독점 잠금이 있습니다.

Codex에서 actas의 제한 사항은 무엇인가요?

Codex에서 $agmsg actas <name>은 해당 세션에 대해서만 전송 측입니다. Codex는 슬래시 명령에 대한 안정적인 session_id를 제공하지 않으므로 피어에게 보이는 독점 잠금을 주장할 수 없으며, 수신 측 폴링은 actas에 의해 좁혀지지 않습니다.

agmsg는 데이터를 어디에 저장하며, 저장 위치를 변경할 수 있나요?

기술은 ~/.agents/skills/<cmd>/ 아래에 있으며, 메시지는 db/messages.db에, 팀 구성은 teams/<team>/config.json 아래에 있습니다. AGMSG_STORAGE_PATH를 설정하여 SQLite 메시지 저장소만 재배치할 수 있습니다(팀 구성은 영향을 받지 않습니다).

팀 이름을 변경하면 어떻게 되나요?

팀 이름을 변경하면 모든 멤버의 등록 및 메시지 기록이 유지됩니다. 팀 이름만 변경됩니다. 그러나 이전 팀 이름을 캐시한 이미 실행 중인 세션은 ID를 다시 확인할 때까지 계속 사용할 수 있습니다. 프로젝트는 이름 변경 후 whoami(예: 제공된 whoami.sh 명령)를 다시 실행하여 새로 고칠 수 있습니다.

agmsg

Q: 에이전트는 어떻게 팀에 가입하고 메시지를 주고받기 시작하나요?

에이전트에서 명령을 실행합니다(예: Claude Code: /agmsg; Codex/Gemini/Antigravity: $agmsg). 처음 사용 시 팀 이름과 에이전트 이름을 묻는 메시지가 표시된 다음 (에이전트 이름, 팀)을 기반으로 ID를 등록합니다. 두 에이전트가 동일한 팀에 가입하면 서로 메시지를 주고받을 수 있습니다.

Q: agmsg가 지원하는 전달 모드는 무엇이며, 어떤 기능을 하나요?

agmsg는 네 가지 전달 모드를 지원합니다: monitor (Claude Code의 기본값; Monitor 도구 및 SQLite 스트림을 통한 실시간 푸시, ~5초 지연), turn (Codex/Copilot CLI의 기본값; 턴 사이에 확인), both (모니터와 턴을 안전망으로 사용), off (자동 전달 없음; 수동 확인만). 모드는 /agmsg mode <monitor|turn|both|off>를 통해 프로젝트별로 설정됩니다.

WebsiteFreeAI Chatbot AI Team Collaboration

agmsg는 경량의 로컬 우선 CLI 메시징 시스템으로, 여러 AI 에이전트(Claude Code, Codex, Gemini CLI, Copilot CLI 등)가 공유 SQLite 데이터베이스를 통해 실시간으로 서로 메시지를 주고받을 수 있도록 합니다. 데몬, 네트워크 및 최소한의 종속성이 필요 없습니다.

웹사이트 방문

이 도구 광고하기

https://github.com/fujibee/agmsg?ref=producthunt&utm_source=aipure

개요
동영상
대안

제품 정보

업데이트됨:Jun 12, 2026

agmsg이란?

agmsg는 명령줄에서 에이전트 간 메시징을 위한 오픈 소스 도구로, 별도의 CLI AI 에이전트가 팀원처럼 직접 통신할 수 있도록 설계되었습니다. 서버나 백그라운드 서비스에 의존하는 대신, 메시지를 공유 SQLite 데이터베이스에 로컬로 저장하고 간단한 스킬/명령 인터페이스(예: Claude Code의 `/agmsg` 또는 다른 CLI의 `$agmsg`)를 제공합니다. 설치 후 에이전트 이름으로 팀에 가입하면 에이전트는 메시지를 보내고, 받은 편지함을 확인하고, 기록을 보고, 팀 구성원을 나열할 수 있어 코드 검토, 작업 인계 및 자율 협업과 같은 작업을 쉽게 조정할 수 있습니다.

agmsg의 주요 기능

agmsg는 CLI AI 에이전트(Claude Code, Codex, Gemini CLI, Copilot CLI 등)를 위한 경량 로컬 교차 에이전트 메시징 시스템으로, 여러 에이전트가 공유 SQLite 데이터베이스를 통해 통신할 수 있도록 합니다. 데몬, 네트워크가 필요 없으며 최소한의 종속성(bash + sqlite3)만 가집니다. 간단한 팀/ID 등록, 메시지 송수신/받은 편지함/기록, 여러 전달 모드(Claude Code Monitor를 통한 실시간 푸시, 훅을 통한 턴 간 폴링, 둘 다 또는 완전 수동)를 제공합니다. 또한 다중 ID 및 세션별 역할 전환을 독점 잠금(Claude Code에서 가장 잘 지원됨)과 함께 지원하여 별도의 세션이 교차 통신 없이 역할의 받은 편지함을 깔끔하게 "소유"할 수 있도록 합니다.

공유 SQLite를 통한 교차 에이전트 메시징: 에이전트는 로컬 WAL 모드 SQLite 저장소를 통해 메시지를 교환하여 서버 실행이나 네트워크 사용 없이 다양한 CLI 에이전트 도구 간에 안정적인 통신을 가능하게 합니다.

데몬 없음, 네트워크 없음, 최소한의 종속성: bash와 sqlite3를 사용할 수 있는 모든 곳에서 실행되도록 설계되었습니다. 스토리지는 파일 시스템에 있으며 상주하는 백그라운드 프로세스가 없습니다.

여러 전달 모드 (모니터/턴/둘 다/끔): 모니터 스트리밍을 통한 Claude Code의 실시간 푸시, 모니터가 없는 도구(예: Codex/Copilot CLI)의 훅을 통한 턴 간 받은 편지함 확인, 결합된 안전 모드 또는 수동 전용 작업을 지원합니다.

프로젝트 간 재사용 가능한 팀 + ID 등록: 에이전트는 (팀, 에이전트 이름) ID로 팀에 가입하고, 여러 프로젝트에서 동일한 ID를 재사용할 수 있으며, 팀 ID를 삭제하지 않고 프로젝트별 등록을 재설정할 수 있습니다.

actas/drop을 통한 다중 역할 워크플로 (세션 범위): 동일한 프로젝트 내에서 에이전트는 actas/drop을 사용하여 역할을 전환할 수 있습니다(예: 기술 리더 대 비즈니스 분석가). Claude Code는 독점 잠금을 요청하여 하나의 활성 세션만 해당 역할의 메시지를 받도록 할 수 있습니다.

운영 유틸리티 (기록, 팀 목록, 팀 이름 변경): 메시지 기록 보기, 팀 구성원 목록, 등록 및 메시지 기록을 보존하면서 팀 이름 변경(이미 실행 중인 세션의 캐시된 팀 이름에 대한 참고 사항 포함)을 위한 명령/스크립트를 포함합니다.

agmsg의 사용 사례

소프트웨어 엔지니어링: 에이전트 간 코드 검토 루프: Claude Code를 기본 드라이버로 사용하고 agmsg를 통해 Codex(또는 다른 에이전트)에 검토/리팩터링 요청을 라우팅한 다음, 주 워크플로로 구조화된 피드백을 다시 받습니다.

다중 에이전트 자율 조정 (로컬 샌드박스): 동일한 팀에서 여러 CLI 에이전트를 실행하여 작업을 실시간으로 조정합니다(예: 문서화된 틱택토 데모). 외부 인프라 없이 에이전트 협업을 실험하는 데 유용합니다.

분리된 역할을 통한 제품/요구사항 분류: actas를 사용하여 동일한 작업 공간에서 별도의 "페르소나"(예: 비즈니스 분석가, 기술 리더)를 유지하여 각 세션이 자체 받은 편지함과 책임에 집중하도록 합니다.

엔터프라이즈/오프라인 환경: 로컬 전용(네트워크 없음)이며 간단한 SQLite 파일을 사용하므로, agmsg는 네트워크 서비스나 백그라운드 데몬이 바람직하지 않거나 허용되지 않는 제한된 환경에 적합합니다.

교차 도구 에이전트 상호 운용성: 서로 다른 CLI 에이전트(Claude Code, Gemini CLI, Codex, Copilot CLI)를 사용하는 팀을 연결하여 이기종 도구 체인 전반에 걸쳐 메시지 및 작업 인계가 일관되게 작동하도록 합니다.

장점

매우 낮은 운영 오버헤드: 데몬 없음, 네트워크 서비스 없음, 최소한의 종속성 (bash + sqlite3).

공유 로컬 메시지 저장소를 사용하여 여러 CLI 에이전트 생태계에서 작동합니다.

유연한 전달 모드 (지원되는 경우 실시간; 지원되지 않는 경우 폴링/훅).

독점성(Claude Code에서 가장 강력함)을 통한 다중 ID 및 역할 분리를 지원합니다.

단점

에이전트 도구에 따라 기능 패리티가 다릅니다(예: Codex는 모니터 스트리밍이 부족하고, actas는 송신 측 전용이며 독점 잠금을 요청할 수 없습니다).

팀 이름 변경은 ID가 다시 해결될 때까지 이전 팀 이름을 캐시한 이미 실행 중인 세션을 혼란스럽게 할 수 있습니다.

독점 잠금은 로컬 활성 확인에 의존하며 오래된 잠금 에지 케이스의 영향을 받을 수 있습니다(v1에서는 완전히 해결되지 않음).

agmsg 사용 방법

1) agmsg 설치: 원라인 설치 프로그램을 실행합니다: `bash <(curl -fsSL https://raw.githubusercontent.com/fujibee/agmsg/main/setup.sh)`. 대안 (먼저 확인): `git clone https://github.com/fujibee/agmsg.git && cd agmsg && ./install.sh`.

2) CLI 에이전트 다시 시작: 새로운 스킬이 검색되도록 Claude Code / Codex / Gemini CLI / Antigravity (및 해당되는 경우 Copilot CLI)를 다시 시작합니다.

3) 에이전트에서 agmsg 명령 실행: 에이전트에서 스킬을 호출합니다: - Claude Code: `/agmsg` - Codex: `$agmsg` - Gemini CLI: `$agmsg` - Antigravity: `$agmsg` (다른 명령 이름으로 설치한 경우 해당 이름을 사용하십시오.)

4) 팀 가입 (첫 실행 프롬프트): 첫 사용 시 agmsg는 팀 이름과 에이전트 이름(귀하의 ID는 `(팀, 에이전트)`)을 묻고, 현재 프로젝트를 해당 ID에 등록합니다.

5) 전달 모드 선택 (첫 실행 프롬프트 또는 나중에): 메시지가 전달되는 방식을 선택합니다: - `monitor` (Claude Code의 기본값): 모니터 도구를 통한 실시간 푸시 (~5초) - `turn` (Codex/Copilot CLI의 기본값): 턴 사이에 확인 - `both`: 모니터 + 턴 안전망 - `off`: 수동으로만 나중에 `/agmsg mode <monitor|turn|both|off>`로 변경할 수 있습니다.

6) ID 및 팀 확인: 스킬을 사용하여 등록되었는지 확인하고 구성원을 확인합니다: - 팀 구성원 목록: `/agmsg team` - 받은 편지함 확인: `/agmsg` - 기록 보기: `/agmsg history`

7) 다른 에이전트에게 메시지 보내기: 현재 ID에서 팀원에게 보냅니다: `/agmsg send <agent> <message>`. 예: `/agmsg send alice "deploy is done"`.

8) 메시지 수신: 메시지는 모드에 따라 도착합니다: - `monitor`: 거의 실시간으로 푸시됨 - `turn`: 다음에 상호 작용할 때 (턴 사이에) 전달됨 - `off`: 수동으로 `/agmsg`를 실행하여 확인

9) 언제든지 전달 모드 전환: 현재 모드 표시: `/agmsg mode`. 모드 설정: `/agmsg mode monitor` (Claude Code), `/agmsg mode turn`, `/agmsg mode both`, 또는 `/agmsg mode off`. 참고: Codex/Copilot CLI는 `turn` 및 `off`만 지원합니다 (모니터 도구 없음).

10) 여러 ID 사용 (선택 사항): 동일한 프로젝트에 대해 여러 에이전트 이름(예: `cc` 및 `reviewer`)을 등록할 수 있습니다. 여러 ID가 존재하는 경우 agmsg는 세션에 사용할 ID를 묻습니다.

11) actas/drop을 사용하여 프로젝트별 여러 역할 사용 (선택 사항, Claude Code에 최적): 세션을 특정 역할 ID로 전환합니다: - `/agmsg actas tech-lead` (필요한 경우 생성한 다음 해당 역할로 송수신을 제한합니다) - `/agmsg drop tech-lead` (이 프로젝트에서 해당 역할을 제거합니다) actas 전환이 실패하여 잠금이 남아 있는 경우 해당 세션에서 `/agmsg drop <name>`을 실행하거나 세션을 종료하여 잠금을 해제하십시오.

12) 프로젝트 등록 나가기/초기화 (선택 사항): 현재 프로젝트 등록을 지웁니다: `/agmsg reset`. (내부적으로는 수동 제어를 위한 스크립트가 존재합니다. 예: `reset.sh <project_path> <type>`.)

13) 팀 이름 변경 (선택 사항, 고급): 제공된 스크립트를 사용하여 팀 이름을 변경합니다 (팀 디렉토리 이동, 구성 업데이트, 메시지 마이그레이션): `~/.agents/skills/agmsg/scripts/rename-team.sh oldteam newteam`. 이름 변경 후 각 구성원은 캐시된 세션이 새 팀 이름을 가져오도록 ID를 다시 확인해야 합니다 (예: 프로젝트에서 whoami를 다시 실행).

14) agmsg 업데이트 (선택 사항): git에서 설치한 경우: `cd agmsg && git pull && ./install.sh --update` (DB 및 팀 구성을 보존하고 스크립트/자산을 업데이트합니다).

15) agmsg 제거 (선택 사항): 모든 것을 제거하려면 `./uninstall.sh` (대화형) 또는 `./uninstall.sh --yes`를 실행하거나, 스킬은 제거하지만 DB/팀은 유지하려면 `./uninstall.sh --keep-data`를 실행합니다.

agmsg 자주 묻는 질문

agmsg는 CLI AI 에이전트(예: Claude Code, Codex, Gemini CLI, GitHub Copilot CLI)를 위한 교차 에이전트 메시징 시스템입니다. 에이전트는 공유 로컬 SQLite 데이터베이스를 통해 서로 메시지를 주고받습니다. 데몬이나 네트워크는 필요하지 않습니다.