whatsapplisted
Install: claude install-skill eddmann/whatsapp-cli
# whatsapp-cli Skill
Query and manage WhatsApp data via the `whatsapp` CLI.
## Prerequisites
- Install CLI: `curl -fsSL https://raw.githubusercontent.com/eddmann/whatsapp-cli/main/install.sh | sh`
- Authenticate: `whatsapp auth login` (scan QR code)
## Quick Context
Get aggregated WhatsApp data in one call:
```bash
whatsapp context # Connection status + recent chats with messages
whatsapp context --chats 10 # More recent chats
whatsapp context --messages 20 # More messages per chat
```
Messages come from a local database. Run `whatsapp sync` to fetch latest messages if history seems stale.
## Commands
Run `whatsapp --help` or `whatsapp <command> --help` to discover all options.
### Chats & Messages
```bash
whatsapp chats [--query NAME] [--groups] [--limit N]
whatsapp messages <JID> [--timeframe today] [--type image] [--limit N]
whatsapp search "keyword" [--chat JID] [--timeframe this_week]
```
### Send, Forward, React
```bash
whatsapp send <JID> "message" [--file photo.jpg] [--reply-to MSG_ID]
whatsapp forward <TO_JID> <MSG_ID> --from <SOURCE_JID>
whatsapp react <MSG_ID> "thumbsup" --chat <JID>
```
### Groups
```bash
whatsapp groups [JID] # List or get info
whatsapp groups join <CODE> # Join via invite
whatsapp groups leave <JID>
```
### Other
```bash
whatsapp contacts [--query NAME]
whatsapp alias [JID NAME] [--remove]
whatsapp download <MSG_ID> --chat <JID>
whatsapp export <JID> [--output file.json]
what