whatsapp-wacli-mac

Interact with WhatsApp via command-line using the WhatsApp Web protocol.

12|3|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/tsukhani/jclaw --skill whatsapp-wacli-mac
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: whatsapp-wacli-mac
Source: https://github.com/tsukhani/jclaw/tree/main/skills/whatsapp-wacli-mac
Command: npx skills add https://github.com/tsukhani/jclaw --skill whatsapp-wacli-mac

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill bridges the gap between your terminal and WhatsApp, allowing you to manage messages, contacts, and groups without needing to manually navigate the web interface.

Core Features & Use Cases

  • Message Management: Search, list, and retrieve context for messages across all your chats.
  • Group & Contact Control: Manage group participants, rename groups, and set local aliases for contacts.
  • Sync & Backfill: Perform one-time or continuous syncs and backfill older chat history from your primary device.

Quick Start

Use the whatsapp-wacli-mac skill to search for messages containing the keyword project in your recent chats.

Frequently Asked Questions about whatsapp-wacli-mac

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

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

You can search WhatsApp messages from the command line by using this skill to query chats containing specific keywords. It interfaces with the WhatsApp Web protocol to retrieve message context across all your chats directly from the terminal.

Can I manage WhatsApp group participants without the web interface?

Yes, you can manage WhatsApp group participants without the web interface. This skill provides command-line controls to manage participants, rename groups, and set local aliases for contacts directly from your terminal.

How do I backfill older WhatsApp chat history on my desktop?

You can backfill older WhatsApp chat history on your desktop by performing a one-time or continuous sync. The skill uses the WhatsApp Web protocol to synchronize and retrieve past chat history from your primary mobile device.

Does WhatsApp CLI automation require an active mobile connection?

Yes, WhatsApp CLI automation requires an authenticated session and a stable connection to your primary mobile device. The skill bridges the terminal and WhatsApp via the web protocol, which depends on the primary device remaining connected.

What are the limitations of syncing WhatsApp chats via a CLI tool?

A limitation of syncing WhatsApp chats via this CLI tool is the strict dependency on a stable connection to the primary mobile device. If the mobile device loses connectivity, the WhatsApp Web protocol session breaks, halting message synchronization.

What is the best way to automate WhatsApp messaging on macOS?

The best way to automate WhatsApp messaging on macOS is using a CLI skill that interfaces directly with the WhatsApp Web protocol. It allows you to list, search, and retrieve message context without manually navigating the web interface.