# Kakaocli

> Send and receive KakaoTalk messages via CLI Use when this capability is needed.

- Skill: `tomevault-io/kakaocli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/kakaocli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/kakaocli/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/kakaocli

---


# KakaoTalk CLI Skill

Read and send KakaoTalk messages from the command line. Requires macOS with KakaoTalk desktop app installed. Auto-launches and auto-logs in when credentials are stored.

## Setup (Required First Time)

```bash
# Store credentials for auto-login
kakaocli login --email user@example.com --password yourpassword
```

## Available Commands

### Check Status
```bash
kakaocli login --status
```

### List Chats
```bash
kakaocli chats --json
```

### Read Messages
```bash
kakaocli messages --chat "Name" --since 1h --json
```

### Send Message
```bash
kakaocli send "Name" "Your message here"
```

### Send to Self-Chat (Testing)
```bash
kakaocli send x --me "Test message"
```

### Watch for New Messages
```bash
kakaocli sync --follow
```

### Search Messages
```bash
kakaocli search "keyword" --json
```

### Harvest Chat Names & History
```bash
# Capture display names for all chats
kakaocli harvest

# Full harvest with scroll + history loading
kakaocli harvest --scroll --top 20
```

## Usage Guidelines

- Always confirm before sending messages to others
- Use `--me` flag and `--dry-run` for testing
- Rate limit: max 1 message per 2 seconds
- Don't send messages between 11 PM and 7 AM unless urgent
- KakaoTalk is auto-launched and auto-logged-in when credentials are stored
- First-time setup requires `kakaocli login --email ... --password ...`

---
> Source: [silver-flight-group/kakaocli](https://github.com/silver-flight-group/kakaocli) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-22 -->