원문: agent-messenger/agent-messenger · 수집일: 2026-10-02 · 버전
2.38.1(2026-09-28) · Stars 221 · Forks 37 · TypeScript · 저장소 생성 2026-01-30 · 기여자 17명 · 홈페이지 agent-messenger.dev
개요
Slack, Discord, Teams, Webex, Telegram, WhatsApp, LINE, WeChat, iMessage, Instagram, KakaoTalk, Channel Talk 12개 메신저를 하나의 명령 체계로 읽고 쓰게 해 주는 CLI와 TypeScript SDK다. 핵심 슬로건은 “Your agent messages as you — not as a bot”. 플랫폼마다 OAuth 앱을 만들고 관리자 승인을 기다리는 대신, 이미 로그인된 데스크톱 앱·브라우저의 세션 토큰을 읽어 에이전트가 사용자 본인의 이름·권한·맥락으로 동작하게 한다. 서버·CI용으로는 봇 토큰 CLI도 따로 제공한다.
같은 접근(데스크톱 앱 토큰으로 사용자 명의 Slack 조작)의 Slack 전용 CLI로 2026-07-30-stablyai-agent-slack이 있다. 두 저장소의 관계는 확인되지 않았고, 이쪽은 범위가 12개 플랫폼과 SDK까지 넓다. README는 Vercel Labs의 agent-browser에서 영감을 받았다고 밝힌다(agent-browser의 성격은 2026-03-21-browser-use-cli-2 비교 참고).
인증 방식
| 방식 | 대상 | 비고 |
|---|---|---|
QR 로그인(auth qr) | Slack, Discord | README가 “가장 안전하고 안정적”이라 권장. 플랫폼 공식 로그인 흐름을 거치므로 디스크의 자격증명을 읽지 않고 데스크톱 앱도 필요 없다 |
| 데스크톱 앱 토큰 자동 추출 | Slack, Discord, Teams, KakaoTalk, Channel Talk | 앱이 없으면 Chromium 브라우저에서 추출, --browser-profile <path>로 프로필 경로 지정 |
| 브라우저 토큰 추출 | Webex, Instagram | Instagram은 아이디·비밀번호 인증도 지원 |
| 일회성 코드 | Telegram(전화번호 코드), WhatsApp(QR·페어링 코드) | Telegram은 my.telegram.org에서 API 자격증명을 자동 발급 |
| 봇 토큰 | Slack·Discord·Webex·Telegram·WhatsApp·WeChat·Channel Talk 봇 CLI | 서버·CI/CD용 |
자격증명·동기화 상태·파생 키 캐시는 기본적으로 ~/.config/agent-messenger에 저장되고, AGENT_MESSENGER_CONFIG_DIR로 위치를 바꿀 수 있다(CI 샌드박스·멀티테넌트용).
구성
- CLI 18종 — 플랫폼별
agent-slack,agent-discord,agent-kakaotalk등과 봇용agent-slackbot,agent-discordbot등.npm install -g agent-messenger한 번으로 모두 설치된다. 출력은 기본 JSON(LLM 도구 사용용),--pretty는 사람용이다. - Agent Skills 18개 — CLI마다 스킬 1개(
skills/agent-*).npx -y skills add agent-messenger/agent-messenger, Claude Code 플러그인 마켓플레이스(claude plugin install agent-messenger), SkillPad로 설치한다. 필요한 스킬만 골라 설치할 수 있다. - TypeScript SDK —
agent-messenger/slack같은 서브패스마다 타입 있는 클라이언트·자격증명 관리자·Zod 스키마를 낸다.new SlackClient().login()처럼 인자 없이 호출하면 CLI와 같은 방식으로 자격증명을 자동 추출한다. - 실시간 리스너(SDK) — Slack(Socket Mode는 봇), Webex(Mercury WebSocket), Teams(trouter WebSocket, 봇 등록·공개 HTTP 엔드포인트 불필요), KakaoTalk(LOCO), Discord 봇(Gateway), Telegram 봇(long-polling), Instagram(MQTToT, 실패 시 폴링 폴백).
- TUI(실험적) —
agent-messenger tui로 여러 플랫폼을 한 터미널 화면에서 본다. README는 SDK의 통합 어댑터 계층을 보여주는 쇼케이스라고 설명한다. - 프로토콜 계층은 플랫폼마다 다르다 — Telegram은 TDLib, WhatsApp은 Baileys, LINE은 Thrift, KakaoTalk은 sub-device 로그인과 LOCO, iMessage는 맥에서 도는
imsg도구를 경유한다.
기능 지원 범위
플랫폼 간 일관되게 지원되는 것은 메시지 전송·조회와 DM이고, 나머지는 Slack에 크게 쏠려 있다. README의 지원표 기준으로 정리하면 다음과 같다.
- Slack만 지원: 활동 피드, 임시 저장, 저장 항목, 사이드바 섹션, 핀·북마크, 예약 메시지, 채널 관리, 리마인더, 사용자 그룹
- Slack·Discord: 스레드, 읽지 않은 메시지(Discord는 멘션 7일 이력과 DM 읽음 표시 기준이며 서버 채널의 일반 미확인 메시지는 제외)
- 검색: Slack·Discord·WhatsApp·Instagram·Channel Talk. Teams·Webex·Telegram·LINE·KakaoTalk는 검색 없음
- 메시지 수정: Slack·Discord·Teams(DM·채팅만)·Webex
- Teams 토큰은 60–90분 만에 만료되어
agent-teams auth extract를 다시 실행해야 한다. - iMessage는 지원표 밖에 있고 맥에서만 동작한다. 입력 표시·수정·회수 등은 SIP 해제가 필요한 imsg 브리지가 있어야 하며 후속 과제로 남아 있다.
설계 철학: MCP 대신 CLI
README는 “Why CLI, not MCP?”에 한 절을 할애한다. MCP는 도구가 한꺼번에 노출되어 컨텍스트가 부풀고 에이전트가 선택지에 혼란스러워하는 반면, 스킬+CLI는 필요한 것만 로드하고 행동당 셸 명령 하나면 되며 상시 서버가 필요 없다는 논지다. SDK는 같은 자격증명·같은 플랫폼 범위로 프로그램 접근이 필요할 때 보완한다. moc-mcp에 쌓인 MCP 컨텍스트 비용 논의와 같은 문제의식이다.
활용 예시(README)
- 컨텍스트 수집 — 장애 스레드의 근본 원인·타임라인 요약, 이전 논의 검색, 읽지 않은 메시지 중 처리 필요한 것 확인
- 보고·소통 — 배포 요약 게시, 스탠드업 작성, 여러 플랫폼 교차 공지, 테스트 커버리지 보고서 업로드
- 자동화 — CI 결과 게시, 마이그레이션 완료 알림, 아침 워크스페이스 스냅샷, 오류율 초과 시 온콜 알림
TypeScript 네이티브 에이전트 런타임 TypeClaw의 멀티채널 메시징에 쓰인다고 소개되어 있다.
위키지기 관점의 주의점
- 사용자 명의로 동작한다는 것은 실수·프롬프트 인젝션의 피해도 사용자 명의로 남는다는 뜻이다. 봇은 권한과 이름이 분리되지만 이 도구에서 에이전트는 계정 소유자와 구분되지 않는다. 읽기 전용 작업과 전송 작업을 분리해서 쓰는 운영 규칙은 README에 없고 직접 정해야 한다.
- 디스크·브라우저에서 세션 토큰을 읽는 방식은 각 서비스의 약관과 충돌할 수 있다. 저자들이 Slack·Discord에 QR 로그인을 “가장 안전”하다고 따로 권장하는 이유로 읽힌다. 다만 이 판단은 README 문장이 아니라 이 노트의 해석이다.
- GitHub
license메타는 비어 있고 README 본문만 MIT라고 적었다(별도 LICENSE 파일은 API에서 확인되지 않음). 사용 전에 라이선스 파일을 직접 확인하는 편이 안전하다. - 지원표의 ✅는 저자 주장이며 실제 동작은 검증하지 않았다.
관련 노트
- 2026-07-30-stablyai-agent-slack — Slack 전용 유사 CLI(관계 미확인)
- openclaw — iMessage 브리지
imsg가 openclaw 조직 저장소를 가리킨다 - telegram — 상시 실행 에이전트의 메신저 채널로서의 Telegram
- 2026-10-04-github-markfulton-agent-cookie-sync — 로그인 세션을 에이전트에 넘기는 또 다른 방식(브라우저 쿠키 동기화)
- moc-mcp — MCP 대신 CLI+스킬을 택하는 흐름과 비교
- moc-ai-agents — 에이전트 도구 지형