wacli

SkillSearch

Lets your agent send WhatsApp messages and search your WhatsApp chat history.

Then ask your AI: use the wacli skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add it as a step in a pipeline you build on Ahel, or connect Ahel to Claude, ChatGPT, Cursor, Claude Code or Codex and ask your AI to use it.

About this skill

Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI.

What this skill tells your AI

The instructions your AI receives, as published by the-open-agent/openagent in skills/wacli/SKILL.md and read by Ahel’s review.

Use wacli when the user asks you to message someone on WhatsApp or to sync/search WhatsApp history.

Safety

  • Require explicit recipient + message text.
  • Confirm recipient + message before sending.
  • If anything is ambiguous, ask a clarifying question.

Auth + sync

  • wacli auth (QR login + initial sync)
  • wacli sync --follow (continuous sync)
  • wacli doctor

Find chats + messages

  • wacli chats list --limit 20 --query "name or number"
  • wacli messages search "query" --limit 20 --chat <jid>
  • wacli messages search "invoice" --after 2025-01-01 --before 2025-12-31

History backfill

  • wacli history backfill --chat <jid> --requests 2 --count 50

Send

  • Text: wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"
  • Group: wacli send text --to "1234567890-123456789@g.us" --message "Running 5 min late."
  • File: wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"

Notes

  • Store dir: ~/.wacli (override with --store).
  • Use --json for machine-readable output when parsing.
  • Backfill requires your phone online; results are best-effort.
  • JIDs: direct chats look like <number>@s.whatsapp.net; groups look like <id>@g.us (use wacli chats list to find).

Signals

GitHub stars
6k
Forks
666
Last commit
Oct 2026
Advanced
Item type
skill
Key
wacli-the-open-agent
Source
github.com/the-open-agent/openagent