Agent KakaoTalk

A TypeScript CLI tool that enables AI agents and humans to interact with KakaoTalk through a simple command interface. Features sub-device login that keeps your desktop app running.

Key Concepts

Before diving in, a few things about KakaoTalk's architecture:

• LOCO protocol = KakaoTalk's binary messaging protocol. The CLI handles this internally — you never interact with it directly.
• Chat rooms = conversations (1:1, group, or open chat). Referenced by numeric chat ID.
• Device slots = KakaoTalk allows one phone + one PC + one tablet session. The CLI registers as a tablet by default to avoid kicking your desktop app.
• Sub-device = a secondary device (PC or tablet). The CLI logs in as a sub-device, so your phone session is never affected.
• Passcode verification = when registering a new device, KakaoTalk displays a code on screen that you confirm on your phone.
• Log ID = a unique numeric identifier for each message, used for pagination.

Quick Start