<p align="center">
<img src="https://raw.githubusercontent.com/matthewdonsemail-lab/log/HEAD/banner.png" alt="log: 커맨드 라인 또는 AI 에이전트에서 소셜 계정 실행" width="100%" />
</p>
<p align="center">
<a href="https://x.com/xAccount/status/2120938715820474690"><img src="https://raw.githubusercontent.com/matthewdonsemail-lab/log/HEAD/media/readme/hermesIntro.gif" alt="ListeningKit의 log 소개, Hermes Agent와의 협업: Hermes가 답장을 기다리는 사람을 묻고, log는 모든 받은 편지함을 읽으며, 답변은 사용자의 목소리로 Discord에 도착합니다." width="100%" /></a>
<br><sub style="font-size: small;">Hermes Agent와의 협업으로 log를 소개합니다. <a href="https://x.com/xAccount/status/2120938715820474690">X에서 소리를 켜고 출시 비디오 시청하기 →</a></sub>
</p>
<h3 align="center">운영하는 모든 소셜 계정에 대한 단 하나의 명령어.</h3>
<p align="center"><b style="font-size: 1.2em;">터미널이나 어떤 에이전트(Claude Code, Codex, Cursor, Hermes, OpenCode, ChatGPT, Claude, Grok 등)를 통해서든 X, Discord, Slack, Instagram, Reddit, LinkedIn 및 Facebook에서 읽고 답장할 수 있습니다.<br><a href="docs/useCases/README.md">모든 기능을 단계별로 확인하기 →</a></b></p>
<p align="center">
<a href="https://www.npmjs.com/package/@listeningkit/log"><img src="https://img.shields.io/npm/v/@listeningkit/log?color=cb3837&label=npm&logo=npm" alt="npm: @listeningkit/log" /></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License: MIT" /></a>
<a href="docs/mcp.md"><img src="https://img.shields.io/badge/MCP-logMcp-7c3aed" alt="MCP 서버: logMcp" /></a>
<a href="https://log.listeningkit.com/docs"><img src="https://img.shields.io/badge/docs-log.listeningkit.com-2ea44f" alt="문서: log.listeningkit.com" /></a>
</p>
curl -fsSL https://log.listeningkit.com/install.sh | sh
claude mcp add log -- logMcp
<table style="width: 100%; border-collapse: collapse;">
<tr>
<td width="50%" valign="middle">
에이전트를 통한 X 사용
"내 X DM을 읽고 누가 나를 기다리는지 알려줘."
</td>
</tr>
</table>
기존 받은 편지함과 암호화된 X 채팅을 하나로 읽습니다.
<td width="50%">
log twitter dms --account <name> --waiting
</td>
<tr >
<td width="50%" valign="middle">
디스코드(Discord), 슬랙(Slack) 및 인스타그램(Instagram) 실시간 연동
새로운 메시지가 도착하는 즉시 에이전트에게 전송됩니다.
</td>
<td width="50%">
log discord read --account <name> --channel "<chat>"
log slack read --account <name> --channel "<chat>"
log instagram dms --account <name>
</td>
</tr >
<tr >
<td width="50%" valign="middle">
사용자의 목소리로 답변 작성
모든 초안은 전송되기 전에 해당 사람에게 실제로 보내는 방식과 비교하여 확인됩니다.
</td>
<td width="50%">
log voice --to <handle> --text "<draft>"
</td>
</tr >
<tr >
<td width="50%" valign="middle">
페이스북 마켓플레이스(Facebook Marketplace) 및 그룹
로컬 계정 전반에 걸쳐 목록을 실시간으로 유지하며, 서비스 요청자가 있는 그룹을 읽습니다.
</td>
<td width="50%">
log facebook listings
log facebook join group --account <name> --group <url>
</td>
</tr >
</table>
<p align="center">📖 <a href="https://log.listeningkit.com/docs"><b>전체 문서 보기 →</b></a></p>
log는 명령줄(command line) 또는 AI 에이전트에서 소셜 계정을 실행합니다. DM, 그룹 채팅, 답글 및 알림을 읽고, 메시지, 답장, 좋아요, 팔로우, 반응 및 음성 메모를 대신 전송합니다. 이는 하나의 명령어 log와 하나의 MCP 서버 logMcp로 구성되어 있으며, 사용자의 장치에서 사용자 계정으로 실행됩니다. 지시할 때까지 아무것도 작동하지 않습니다: 무언가를 변경하는 모든 명령어는 --live 플래그를 추가하기 전까지는 건식 실행(dry run)입니다. 이는 무료이며 오픈 소스입니다.
빠른 시작
설치
curl -fsSL https://log.listeningkit.com/install.sh | sh
irm https://log.listeningkit.com/install.ps1 | iex
curl -fsSL https://log.listeningkit.com/install.sh | sh -s -- --skills all
이 명령어는 log 및 logMcp 명령과 플랫폼 엔진에 필요한 모든 것을 갖춘 Python을 설치합니다. 설정은 ~/.logCli/.env에 작성됩니다. 이미 Bun이 있습니까? bun add -g @listeningkit/log를 사용하면 명령어만 설치됩니다. 이미 log가 있습니까? --skills all --skillsOnly는 스킬만 추가합니다. Windows에서는 PowerShell 라인 전에 $env:LOG_SKILLS = "all"을 설정하세요. 더 알아보기: docs/install.md.
계정 연결하기
계정을 한 번 추가하고 로그인한 다음, 플랫폼이 여전히 이를 수락하는지 확인합니다:
| Platform | How to sign in |
|---|
| X | log twitter cookies save --account <handle>: 쿠키 내보내기 확장 프로그램에서 auth_token, ct0 및 twid를 붙여넣으세요 |
| ... | |
이후 log <platform> session check --account <name>으로 확인합니다. 이 명령어는 아무것도 전송하지 않습니다. 응답은 loggedIn, loggedOut 또는 restricted입니다. 쿠키는 항상 마스킹된 프롬프트에 입력되어야 하며 플래그로 전달되어서는 안 됩니다. 더 알아보기: docs/accounts.md.
에이전트 연결하기
| Agent | How to connect |
|---|
| Claude Code | claude mcp add log -- logMcp |
| ... | |
그다음 평범한 말로 요청합니다: "내 X DM을 읽고 누가 나를 기다리고 있는지 알려줘". log의 라우터가 해당 요청에 대한 플레이(play) 이름을 지정하고, 에이전트가 그 단계를 따릅니다. 모든 하네스와 각 하네스가 할 수 있는 일: Works in every harness.
플랫폼
| Platform | What log does | How it talks to the platform |
|---|---|
| X | DM 및 X Chat, 알림, 팔로워, 답글, 게시물, 좋아요, 팔로우, 목록, 반응, 음성 메모, 큐 | 자체 API 클라이언트, 계정당 하나의 세션, 브라우저 사용 안 함 |
| ... |
하이라이트
- 플레이(Play)부터 시작합니다. 각 use case는 단계별 워크플로우로 작성되어 있습니다: 무엇을 실행해야 하는지, 그리고 각 단계가 성공했음을 알려주는 것은 무엇인지입니다.
--skills all을 사용하면 에이전트가 사용자가 말하는 내용 중 적절한 것을 선택합니다.
- 당신의 목소리, 검증됩니다. 초안은 전송되기 전에 AI 문구와 숨겨진 문자까지 고려하여 실제로 그 사람에게 쓰는 방식과 비교됩니다.
- 계정당 하나의 세션입니다. 각 계정은 플랫폼 자체 앱처럼 연결을 하나만 유지하며, 명령어마다 새로운 연결을 만들지 않습니다.
- 실시간 받은 편지함(Live inbox). 새 메시지는 도착하는 즉시 에이전트의 컨텍스트에 푸시되고, 두 에이전트가 같은 채팅에 답변하지 않습니다.
- 인간적인 느낌 유지. 모든 계정은 자체 일일 제한, 속도 조절(pacing), 그리고 지역별 기상 시간을 가집니다. 플랫폼에서 거부되면 실행이 중단되며 재시도는 없습니다.
- 당신의 장치, 당신의 데이터. 계정과 세션은
~/.logCli에 보관됩니다. 여러 개의 계정이 필요한가요? 모든 장치, 에이전트, 팀원이 동일한 것을 볼 수 있도록 오픈 소스 CRM인 Twenty에 보관하세요.
모든 하네스(Harness)에서 작동합니다
하네스는 사용자가 log를 통해 대화하는 에이전트 앱입니다. log는 이 모든 곳에서 동일한 MCP 서버이며, 동일한 이름의 도구들을 가지고 있습니다. 변경되는 것은 log의 안내가 모델에 도달하는 방식과 새로운 메시지가 도달하는 방식입니다:
| 하네스 | 연결 대상 | 작동 지시 방식 | 새 메시지 수신 방식 | 보기 및 로그인 |
|---|
| Claude Code | 로컬 또는 호스팅 | 프롬프트 훅이 모든 프롬프트에서 라우터를 실행합니다 | 모든 프롬프트와 도구 호출 후에 훅 작동 | 텍스트; 화면의 창에서 로그인 |
| ... | | | | |
전체 표는 코드(src/agentHooks/harness/types.ts의 HARNESSES)에서 작성되었으며, 각 훅의 텍스트 제한 및 훅이 위치한 곳은 docs/harnesses를 참조하세요. | | | | |
Hermes를 위한 log 플러그인
Hermes는 사용자의 기기 또는 서버에서 하루 종일 실행되며, Telegram, Slack 및 데스크톱 앱을 통해 사용자에게 알림을 보냅니다. log 플러그인은 Hermes에 log의 도구들, 모든 기능을 스킬로, 그리고 대시보드 내의 log 탭을 제공합니다. Hermes는 자유롭게 읽어들이며, 보내기, 답장 또는 게시물 작성 시마다 사용자에게 먼저 확인을 요청합니다.
hermes plugins pack install https://log.listeningkit.com/hermes-pack.yaml
단 하나의 명령어로 두 가지 절반을 모두 설치하고 활성화합니다: log(log의 도구들, 모든 기능을 스킬로, 대시보드의 log 탭)와 logHooks(라우터 후크). Hermes는 해당 패키지가 어떤 커밋에 고정되어 설치되는지 보여주며, 한 번만 요청합니다. 먼저 log 자체를 설치하고, 후크가 스스로 찾아내도록 합니다.
<table>
<tr
><td width="50%"><img src="https://raw.githubusercontent.com/matthewdonsemail-lab/log/HEAD/hermesPlugin/docs/screenshots/xInbox.jpg" alt="Hermes가 답장을 기다리는 사람을 묻고, log는 사용자에게 대기 중인 X 대화를 찾아냅니다" /></td>
<td width="50%"><img src="https://raw.githubusercontent.com/matthewdonsemail-lab/log/HEAD/hermesPlugin/docs/screenshots/yourVoice.jpg" alt="어떤 것이 보내지기 전에 확인되는 사용자 자신의 목소리로 작성된 초안" /></td>
</tr>
<tr
><td><sub style="font-size: 0.9em;">누가 당신을 기다리는지, 모든 받은 편지함에서 읽습니다.</sub></td>
<td><sub style="font-size: 0.9em;">어떤 것이 보내지기 전에 확인되는 사용자 자신의 목소리로 작성된 초안.</sub></td>
</tr>
<tr width="50%"><img src="https://raw.githubusercontent.com/matthewdonsemail-lab/log/HEAD/hermesPlugin/docs/screenshots/platforms.jpg" alt="log의 플랫폼 카드: Slack, Instagram 등, 각기 사용자 자신의 세션에서" /></td>
<td width="50%"><img src="https://raw.githubusercontent.com/matthewdonsemail-lab/log/HEAD/hermesPlugin/docs/screenshots/dashboard.png" alt="Hermes 대시보드의 log 탭: 누가 기다리는지, 모든 계정의 세션 및 오늘의 발송 내역" /></td>
</tr>
<tr
><td><sub style="font-size: 0.9em;">사용자가 접속하는 모든 플랫폼, 각기 사용자 자신의 세션에서.</sub></td>
<td><sub style="font-size: 0.9em;">log 탭: 누가 기다리는지, 모든 계정의 세션, 제한 대비 오늘의 발송 내역.</sub></td>
</tr>
</table>
하나의 기능, 모든 인터페이스에서
log가 수행할 수 있는 모든 기능은 이름이 하나이며, CLI(Command Line Interface), MCP 서버, 그리고 로그 콘솔에서 모든 플랫폼에 걸쳐 동일하게 작동합니다. 플랫폼은 기본값이 아니라 사용자가 지정하는 값입니다:
- 공유 도구.
log chats list, log messages read|send|react|watch 및 해당 MCP 도구(chatsList, messagesRead, messagesSendLive)는 X, Discord, Slack, Instagram, Facebook에서 작동하며, 플랫폼은 계정으로부터 가져옵니다.
- 단일 로그인.
log sessions signIn (MCP: sessionsSignIn)을 실행하면 계정 자체의 브라우저가 열리고, 사용자는 해당 플랫폼의 로그인 화면에서 로그인합니다. 세션은 플랫폼이 로그인되었다고 표시할 때만 한 번 저장됩니다. 로그아웃된 브라우저는 좋은 세션을 덮어쓰지 않습니다. log sessions check는 모든 계정에 대해 한 번에 응답합니다.
- 로그 콘솔.
log console은 터미널 콘솔과 동일한 작업을 수행하며, --web 플래그를 사용하면 자체 기기에서 웹 콘솔로도 사용할 수 있습니다. 모든 콘솔 화면에는 이에 맞는 명령어가 존재합니다.
- 뷰(Views).
report는 log 자체 데이터로부터 뷰를 그립니다. 반면 browserView는 채팅창에서 계정의 실시간 브라우저를 보여주며, 여기서 호스트가 MCP 앱을 그립니다. 다른 곳에서는 둘 다 텍스트 형태로 표시됩니다.
- 스크립트가 아닌 기계(Machines). 시간이 지남에 따라 실행되는 모든 것(로그인, 세션 확인, 각 계정의 감시자, 전송, 대기열 실행)은 상태 머신(state machine)이므로, 충돌하더라도 미완료된 상태를 남기지 않습니다.
작동 방식
log는 사용자 기기에 로컬 데이터베이스인 ~/.logCli/log.db에 필요한 모든 것을 보관합니다. 플랫폼들은 발생하는 대로 이 데이터베이스에 정보를 푸시합니다. 따라서 사용자가 또는 에이전트가 “무슨 말을 했는지?”라고 물으면, log는 플랫폼에 다시 요청하여 몇 초가 걸리는 대신 자체 데이터베이스를 약 밀리초 만에 읽어옵니다.
전체 그림
flowchart LR
subgraph platforms["플랫폼들"]
X["X 및 X Chat"]
...
간단히 설명하자면:
- 계정당 하나의 세션(One session per account)을 유지합니다. 각 계정은 플랫폼 자체 앱과 마찬가지로 열린 세션을 하나만 유지합니다. log는 명령어마다 새로운 세션을 열지 않습니다.
- 계정당 하나의 워처(watcher)를 가집니다. 이는 플랫폼 자체의 푸시 채널(X Chat의 소켓, Discord의 게이트웨이, Slack의 소켓, Instagram의 실시간 연결 등)을 보유합니다. 도착하는 모든 것은 이벤트로 간주되어
log.db에 한 번 기록됩니다.
- 나머지 모든 것은 이러한 이벤트들로부터 처리됩니다. 여기에는 채팅 내용, 누가 무엇을 말했는지, 사진이나 비디오가 보여주는 것, 음성 메모의 내용, 그리고 검색 인덱스가 포함됩니다. 채팅과 메시지는 언제든지 이벤트로부터 재구축될 수 있습니다.
- 에이전트(agent)는 플랫폼이 아닌 데이터베이스에 요청합니다. 툴 호출(tool call)은 데이터베이스를 읽습니다. 플랫폼은 무언가를 전송하거나 간격 이후의 내용을 따라잡기 위해서만 호출됩니다.
- 후크(Hooks)가 새로운 정보를 에이전트에게 푸시합니다. 누군가가 글을 쓰면, 에이전트는 요청하지 않아도 즉시 그 내용을 컨텍스트에서 확인합니다.
에이전트가 연결되는 방식과 재시작할 필요가 없는 이유
sequenceDiagram
participant C as Claude Code
participant P as logMcp, the reload proxy
...