macOS용 카카오톡 데스크탑 앱을 위한 비공식 CLI입니다.
터미널에서 직접 쓰기 좋고, JSON 출력, watch, hook, webhook 흐름으로 AI나 agent가 호출하기에도 적합합니다.
실행 바이너리는 openkakao-rs입니다.
Quick Start · 핵심 · 문서 · Claude Code Skill
한국어 | English
Warning
이 프로젝트는 카카오(Kakao Corp.)와 무관한 비공식 CLI입니다. 연구, 자동화, 로컬 워크플로 용도로 만들었고, 카카오의 승인이나 보증을 받지 않았습니다. 사용 방식에 따라 카카오 이용약관 또는 운영정책 위반으로 해석될 수 있으며, 그 경우 사용자 계정이 정지되거나 영구 삭제될 수 있습니다. 사용 전에 관련 정책을 직접 확인하고, 모든 책임은 사용자 본인에게 있음을 전제로 신중히 사용하세요.
| Works with |  OpenClaw |
 Claude Code |
 Codex |
 Cursor |
 Bash |
 HTTP |
# Homebrew
brew tap JungHoonGhae/openkakao
brew install openkakao-rs
# 1. 인증 정보 저장
openkakao-rs login --save
# 2. 채팅방 목록
openkakao-rs chats
# 3. 메시지 읽기
openkakao-rs read <chat_id> -n 20
# 4. 메시지 보내기
openkakao-rs send <chat_id> "Hello from CLI!"필요할 때만 예전 cache-backed 경로를 강제합니다.
openkakao-rs chats --rest
openkakao-rs read <chat_id> --rest
openkakao-rs members <chat_id> --rest# 구조화된 출력
openkakao-rs --json chats
openkakao-rs --json read <chat_id> -n 20
# 실시간 이벤트 감시
openkakao-rs watch --json
# 로컬 hook 또는 webhook 흐름으로 연결
openkakao-rs --unattended --allow-watch-side-effects watch \
--hook-cmd 'jq . > /tmp/openkakao-event.json'Claude Code에서 바로 쓰려면:
npx skills add JungHoonGhae/skills@openkakao-cli- macOS 카카오톡 앱에서 인증 정보 추출
- 채팅, 메시지, 멤버, 친구, 프로필 조회
- LOCO 기반 메시지 전송, 실시간 watch, 미디어 처리
--json출력으로jq,cron, SQLite, LLM 흐름과 연결 가능watch,hook,webhook로 로컬 자동화와 에이전트 워크플로에 연결 가능friends --local,profile --local,profile --chat-id로 일부 조회 복구 가능
- 채팅 기록을 JSON으로 읽어서 다른 도구로 넘기고 싶을 때
- 카카오톡을 로컬 스크립트나 운영 도구의 입력 채널로 쓰고 싶을 때
- watch 이벤트를 hook이나 webhook으로 받아 후속 작업을 실행하고 싶을 때
- 사람이 직접 쓰는 CLI와 AI가 호출하는 로컬 인터페이스를 같이 두고 싶을 때
| Requirement | Notes |
|---|---|
| macOS | 카카오톡 데스크탑 앱 설치 및 로그인 필요 |
| Rust >= 1.75 | 소스 빌드 시 |
brew tap JungHoonGhae/openkakao
brew install openkakao-rsgit clone https://github.com/JungHoonGhae/openkakao.git
cd openkakao/openkakao-rs
cargo install --path .- 문서 사이트: https://openkakao.vercel.app/
- 빠른 시작: https://openkakao.vercel.app/docs/getting-started/quickstart/
- CLI 레퍼런스: https://openkakao.vercel.app/docs/cli/overview/
- 자동화 개요: https://openkakao.vercel.app/docs/automation/overview/
- LLM / agent 워크플로: https://openkakao.vercel.app/docs/automation/llm-agent-workflows/
- watch 패턴: https://openkakao.vercel.app/docs/automation/watch-patterns/
- 프로토콜 문서: https://openkakao.vercel.app/docs/protocol/overview/
Reverse engineering / local app-state diff:
openkakao-rs profile-hints --local-graph --json
openkakao-rs profile-hints --app-state --json > /tmp/profile-before.json
openkakao-rs profile-hints --app-state --app-state-diff /tmp/profile-before.json --jsonnpx skills add JungHoonGhae/skills@openkakao-clicd openkakao-rs
cargo build --release자세한 사용법, 운영 메모, 프로토콜 설명은 문서 사이트에 정리되어 있습니다.
이 프로젝트가 도움이 되셨다면 응원해 주세요:
버그 제보와 PR 환영합니다.
MIT