CLI-based utility to send messages and sync WhatsApp history for external contacts.
Install
mkdir -p .claude/skills/wacli-x402agent && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/11769" && unzip -o skill.zip -d .claude/skills/wacli-x402agent && rm skill.zipInstalls to .claude/skills/wacli-x402agent
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).Key capabilities
- →Send text messages to specified recipients
- →Send files with captions to specified recipients
- →List chats with a query and limit
- →Search messages within a chat by query and date range
- →Perform initial QR login and continuous sync for WhatsApp history
- →Backfill chat history for a specific chat ID
How it works
The skill uses the wacli command-line interface to interact with WhatsApp, allowing operations like sending messages or syncing history. It requires explicit confirmation for recipient and message text before sending.
Inputs & outputs
When to use wacli
- →Sending a message to a contact
- →Syncing message history via cli
- →Searching chat history for invoices
About this skill
wacli
Use wacli only when the user explicitly asks you to message someone else on WhatsApp or when they ask to sync/search WhatsApp history.
Do NOT use wacli for normal user chats; NanoClawd routes WhatsApp conversations automatically.
If the user is chatting with you on WhatsApp, you should not reach for this tool unless they ask you to contact a third party.
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 "[email protected]" --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
--jsonfor machine-readable output when parsing. - Backfill requires your phone online; results are best-effort.
- WhatsApp CLI is not needed for routine user chats; it’s for messaging other people.
- JIDs: direct chats look like
<number>@s.whatsapp.net; groups look like<id>@g.us(usewacli chats listto find).
When not to use it
- →For normal user chats within NanoClawd
- →When the user is chatting with you on WhatsApp and does not ask to contact a third party
Prerequisites
Limitations
- →Not for normal user chats
- →Requires explicit recipient and message text confirmation
- →History backfill requires the phone to be online
How it compares
This skill provides a programmatic way to interact with WhatsApp outside of standard chat flows, enabling automated messaging and history management through CLI commands.
Compared to similar skills
wacli side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| wacli (this skill) | 0 | 3mo | No flags | Intermediate |
| himalaya | 50 | 2mo | Review | Intermediate |
| officeemail-management | 8 | 8mo | No flags | Intermediate |
| gmail | 16 | 6mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
himalaya
openclaw
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
officeemail-management
harperreed
Handle email tasks (checking inbox, drafting replies, managing threads, adding events to calendar). Use when working with emails to prevent common mistakes like broken threading or missing recipients.
gmail
team-attention
This skill should be used when the user asks to "check email", "read emails", "send email", "reply to email", "search inbox", or manages Gmail. Supports multi-account Gmail integration for reading, searching, sending, and label management.
sendgrid-automation
sickn33
Automate SendGrid email operations including sending emails, managing contacts/lists, sender identities, templates, and analytics via Rube MCP (Composio). Always search tools first for current schemas.
klaviyo
alinaqi
Klaviyo email/SMS marketing - profiles, events, flows, segmentation
slack
motoya0118
Post a question to Slack and wait for a reply, or post a reply into a thread using scripts/slack.py.