wacli

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

Updated Jun 18, 2026
One-click install
npx skills add https://github.com/wangqianCAI/OBI --skill wacli-wangqiancai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wacli
Source: https://github.com/wangqianCAI/OBI/tree/main/skills/wacli
Command: npx skills add https://github.com/wangqianCAI/OBI --skill wacli-wangqiancai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the friction of interacting with WhatsApp for non-routine tasks, such as searching through historical messages or sending messages to third parties outside of active AI-user conversations.

Core Features & Use Cases

  • Message Management: Send text or files to specific contacts or groups using their JID or phone number.
  • History Sync & Search: Search through past conversations, sync history, and backfill data for specific chats.
  • Use Case: If you need to find a specific invoice sent in a WhatsApp thread from last year or send a file to a contact not currently in your active chat session, this tool provides the necessary interface.

Quick Start

Use the wacli skill to search for messages containing the word invoice in the chat with the contact identified by the number 14155551212.

Frequently Asked Questions about wacli

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

FAQPage Schema
How do I search through WhatsApp chat history for specific past messages?

You can search WhatsApp chat history by using the command-line interface to query past conversations for specific keywords, sync historical data, or backfill messages for targeted contacts and groups.

Can I automate sending WhatsApp messages and files via command line?

Yes, you can automate sending WhatsApp messages by dispatching text or files to specific contacts and groups using their JID or phone number directly from the command line.

Do I need to authenticate to manage WhatsApp messaging through a CLI?

Yes, managing WhatsApp messaging through a CLI requires the wacli binary and active authentication to securely interact with the WhatsApp network for sending and retrieving data.

What is the best way to send a file to a WhatsApp contact outside an active chat session?

The best way to send a file to a contact outside an active session is using a CLI tool to dispatch files directly to their phone number or JID without opening the chat interface.

How do I backfill missing data for a specific WhatsApp chat?

You can backfill missing data for a specific WhatsApp chat by executing a history synchronization command via the CLI, which retrieves and syncs past messages for that conversation.