Skip to main content
ClaudeWave
Skill5.2k repo starsupdated today

wacli

wacli is a command-line interface for WhatsApp automation that enables users to send messages, search conversation history, and synchronize WhatsApp data. Use it when the user requests sending WhatsApp messages to contacts or groups, searching past messages by date or keyword, or retrieving WhatsApp chat history. The tool requires explicit recipient confirmation before sending and supports text messages, file attachments, and group messaging through QR code authentication.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/the-open-agent/openagent /tmp/wacli && cp -r /tmp/wacli/skills/wacli ~/.claude/skills/wacli
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# wacli

Use `wacli` when the user asks you to message someone on WhatsApp or to sync/search WhatsApp history.

Safety

- Require explicit recipient + message text.
- Confirm recipient + message before sending.
- If anything is ambiguous, ask a clarifying question.

Auth + sync

- `wacli auth` (QR login + initial sync)
- `wacli sync --follow` (continuous sync)
- `wacli doctor`

Find chats + messages

- `wacli chats list --limit 20 --query "name or number"`
- `wacli messages search "query" --limit 20 --chat <jid>`
- `wacli messages search "invoice" --after 2025-01-01 --before 2025-12-31`

History backfill

- `wacli history backfill --chat <jid> --requests 2 --count 50`

Send

- Text: `wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"`
- Group: `wacli send text --to "1234567890-123456789@g.us" --message "Running 5 min late."`
- File: `wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"`

Notes

- Store dir: `~/.wacli` (override with `--store`).
- Use `--json` for machine-readable output when parsing.
- Backfill requires your phone online; results are best-effort.
- JIDs: direct chats look like `<number>@s.whatsapp.net`; groups look like `<id>@g.us` (use `wacli chats list` to find).