skills.rest
BEIRUX
BEIRUXOFFICIAL
Explore all skills by this author →
GitHub

wacli

Send WhatsApp messages and search or sync chat history via command-line interface.

Updated Apr 3, 2026
Search Tags:#messaging#cli#sync#whatsapp#wacli#chat-search#jid
One-click install
npx skills add https://github.com/BEIRUX/agent-skills --skill wacli-beirux
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/BEIRUX/agent-skills/tree/main/wacli
Command: npx skills add https://github.com/BEIRUX/agent-skills --skill wacli-beirux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide a safe, scriptable way to send WhatsApp messages to third parties and to search or sync WhatsApp chat history from the command line, avoiding manual phone interactions for programmatic messaging and archive retrieval.

Core Features & Use Cases

  • Authentication & Sync: QR-based auth with wacli auth and continuous sync options for keeping local stores up to date.
  • Search & Backfill: Search messages by query, date ranges, or chat JID and backfill history for archival retrieval.
  • Message Sending: Send texts, group messages, and files to specified JIDs with machine-readable JSON output for automation.
  • Safety Practices: Require explicit recipient and message confirmation, avoid using for routine user chats, and use --json for parsing outputs.

Quick Start

Use the wacli skill to send a WhatsApp message to +14155551212 with the text Hello! Are you free at 3pm? and confirm the recipient and message before sending.

Frequently Asked Questions about wacli

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

FAQPage Schema
How do I send WhatsApp messages from the command line?▼

Search WhatsApp chat history from the CLI by running a query against synced local stores. The tool supports filtering by text query, date ranges, or chat JID, and outputs results as JSON for easy parsing or programmatic retrieval in automation scripts.

Do I need an online phone to backfill WhatsApp chat history?▼

WhatsApp JID addressing for CLI messaging requires specifying the recipient's JID, such as a phone number formatted as +14155551212. The tool uses this explicit JID for message routing and requires recipient confirmation before sending texts, group messages, or files.

Can I export WhatsApp messages as JSON for automation scripts?▼

Yes, export WhatsApp messages as JSON for automation by running search or sync commands with the --json flag. This provides machine-readable output of message history, enabling programmatic retrieval, parsing, and archival of chat data without manual phone interactions.

What are the safety practices for programmatic WhatsApp messaging?▼

Sync WhatsApp chat history locally by completing QR-based authentication with the wacli auth command. This enables continuous sync options to keep local stores updated, allowing you to search and backfill message history for archival retrieval via the command line.

Related Skills

Explore More Software Engineering Skills→
steipetesteipete
385.7k

wacli

Automate WhatsApp messaging workflows via the wacli CLI.

Community
Intermediate
zkcpkuzkcpku

wacli

Send WhatsApp messages and search chat history via command-line interface.

Community
Intermediate
samttoo22-MewCatsamttoo22-MewCat
19

wacli

Send WhatsApp text/file messages and search chat history via wacli.

Community
Intermediate
Yapie0Yapie0
55

wacli

Automate WhatsApp messaging and chat history sync via the wacli CLI.

Community
Advanced