wacli

Send WhatsApp messages and search chat history via the wacli CLI.

1|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/Solizardking/Solana-Robotics-Kit --skill wacli-solizardking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/Solizardking/Solana-Robotics-Kit/tree/main/eliza/packages/skills/skills/wacli
Command: npx skills add https://github.com/Solizardking/Solana-Robotics-Kit --skill wacli-solizardking

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you message third parties on WhatsApp and search or backfill WhatsApp chat history from the command line, without touching the WhatsApp app manually. ## Core Features & Use Cases - Send Messages: Send text or files to individual contacts or groups using phone numbers or JIDs. - Search & Sync History: Authenticate via QR login, sync conversations continuously, and search messages by keyword, chat, or date range. - History Backfill: Request older message history from your phone for a specific chat. - Use Case: A user asks the assistant to text a colleague on WhatsApp about a meeting time, or to find an old invoice mentioned in a past WhatsApp conversation. ## Quick Start Ask the assistant to send a WhatsApp message to a specific phone number with your exact message text, then confirm the recipient and content before it is sent.

Frequently Asked Questions about wacli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a WhatsApp message from the command line?

Use wacli send text with the --to flag for the recipient phone number or JID and --message for the text. For files, use wacli send file with --file and an optional --caption.

How do I search WhatsApp chat history with wacli?

Run wacli messages search with your query, optionally filtering by --chat JID or date range using --after and --before. Use wacli chats list to find the correct chat JID first.

How do I install and authenticate wacli?

Install via brew (steipete/tap/wacli) or go install from github.com/steipete/wacli. Then run wacli auth to log in with a QR code and perform the initial sync.

When should I not use the wacli CLI for WhatsApp?

Do not use wacli for normal user chats, since the host assistant routes WhatsApp conversations automatically. It is only for messaging third parties or searching and syncing history when explicitly requested.

Why does WhatsApp history backfill not return all messages?

Backfill requires your phone to be online and results are best-effort, so some older messages may not be retrieved. You can increase coverage with the --requests and --count flags.