What problem does it solve?
AI agents can interact with WhatsApp via a CLI to send, read, and manage chats, eliminating the need for UI toggles or manual steps and enabling automation.
Core Features & Use Cases
- QR and pairing login: Authenticate as a companion device so phones stay linked without exposing credentials or tokens.
- Send, read, and react: Send messages, list chats, read histories, and react to messages across individual and group chats.
- Multi-account support: Link and switch between multiple WhatsApp numbers with per-command account selection.
- JSON-first output: Default JSON, with a --pretty option for human-readable formatting, suitable for AI consumption.
- On-demand connections: Each command opens a WebSocket session and closes it after completion to minimize background activity.
- Reference material available: Contextual references describe authentication, usage patterns, and troubleshooting.
Quick Start
Install the agent-messenger package and run agent-whatsapp to begin linking your account.