Agent Skills
› composio-community/awesome-agent-clis
› WhatsApp CLI (wacli)
WhatsApp CLI (wacli)
GitHubWhatsApp CLI工具，支持消息同步、搜索、发送及群组管理。用于Agent通过终端执行WhatsApp通信任务，如发送文本/文件、检索历史记录和管理群聊，提供结构化JSON输出以便自动化集成。
Trigger Scenarios
用户需要通过WhatsApp发送消息或文件
用户需要搜索或检索WhatsApp聊天记录
用户需要管理WhatsApp群组（如列表、重命名）
Install
npx skills add composio-community/awesome-agent-clis --skill WhatsApp CLI (wacli) -g -y
SKILL.md
Frontmatter
{
"name": "WhatsApp CLI (wacli)",
"description": "CLI for WhatsApp messaging — sync history, search messages, send texts and files, manage contacts and groups. Use when an agent needs to send WhatsApp messages, search chat history, or manage WhatsApp groups."
}
wacli — WhatsApp CLI
Sync, search, and send WhatsApp messages from the terminal. Built on whatsmeow (WhatsApp Web protocol).
- Repo: https://github.com/steipete/wacli
- Author: @steipete
Installation
brew install steipete/tap/wacli
Or build from source:
go build -tags sqlite_fts5 -o ./dist/wacli ./cmd/wacli
Authentication
# Shows QR code — scan with WhatsApp on your phone
wacli auth
# Start continuous sync (must be authenticated first)
wacli sync --follow
Default store directory: ~/.wacli (override with --store DIR).
Key Commands
Send Messages
# Send a text message
wacli send text --to 1234567890 --message "hello"
# Send a file with caption
wacli send file --to 1234567890 --file ./photo.jpg --caption "Check this out"
# Send a file with custom display name
wacli send file --to 1234567890 --file /tmp/abc123 --filename report.pdf
Search Messages
wacli messages search "meeting"
wacli messages search "project update" --json
Groups
wacli groups list
wacli groups rename --jid 123456789@g.us --name "New Group Name"
History Backfill
# Backfill older messages for a chat (requires primary device online)
wacli history backfill --chat 1234567890@s.whatsapp.net --requests 10 --count 50
Media
wacli media download --chat 1234567890@s.whatsapp.net --id <message-id>
Diagnostics
wacli doctor
Output Modes
- Default: human-readable
--json: structured JSON output for agents
Environment Variables
WACLI_DEVICE_LABEL: set linked device label shown in WhatsAppWACLI_DEVICE_PLATFORM: override linked device platform (defaults toCHROME)
Version History
- 9f765d2 Current 2026-07-24 16:04
