Can it send WhatsApp messages to other people?

Yes. It sends text or files to a phone number or group JID with wacli send text or wacli send file, after the recipient and message are confirmed.

Can it search or sync WhatsApp history?

Yes. It searches messages by query, chat, and date range, lists chats, and backfills or syncs history from the linked phone. Backfill needs the phone online and results are best-effort.

Is it for normal user chats?

No. It is for messaging third parties and for searching or syncing history, not for handling the user's own chats.

What do I need before using it?

The wacli binary must be installed, and you need to run wacli auth to log in with a QR code and do the initial sync.

wacli

SkillSearch

wacli is a skill that lets an AI agent send WhatsApp messages to other people and search or sync WhatsApp history through the wacli command-line tool. It is meant for messaging third parties and for looking up past messages, not for handling the user's own chats. The agent confirms the recipient and message before sending.

Connect your AI Use it in a pipeline

Then ask your AI: use the wacli skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.

No other account needed.

Install the wacli binary, for example with brew or go.

What your AI can do with it

Send WhatsApp text messages to a phone number or group
Send files with an optional caption to a contact or group
Search message history by query, chat, and date range
List chats by name or number
Backfill or continuously sync history from the linked phone
Run wacli doctor to check the setup

Getting started

Install the wacli binary, for example with brew or go.
Run wacli auth to log in with a QR code and do the initial sync.
Run wacli sync --follow to keep history syncing continuously.
Use wacli chats list to find the chat or group you want.
Send a message with wacli send text or wacli send file after confirming the recipient and text.

What this skill tells your AI

The instructions your AI receives, as published by spinabot/brigade in skills/wacli/SKILL.md and read by Ahel’s review.

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; Brigade 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 "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.
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 (use wacli chats list to find).

Signals

GitHub stars: 11k
Forks: 70
Last commit: Oct 2026

Others that do the same job

wacli
Skill · hvwin8 wacli
Skill · seedprod

Questions

Can it send WhatsApp messages to other people?: Yes. It sends text or files to a phone number or group JID with wacli send text or wacli send file, after the recipient and message are confirmed.
Can it search or sync WhatsApp history?: Yes. It searches messages by query, chat, and date range, lists chats, and backfills or syncs history from the linked phone. Backfill needs the phone online and results are best-effort.
Is it for normal user chats?: No. It is for messaging third parties and for searching or syncing history, not for handling the user's own chats.
What do I need before using it?: The wacli binary must be installed, and you need to run wacli auth to log in with a QR code and do the initial sync.

Advanced

Item type: skill
Key: wacli-spinabot
Source: github.com/spinabot/brigade

github.com/spinabot/brigade