wacli

wacli is a skill for Claude Code, Codex from samttoo22-MewCat/OpenSoul. It costs 31 tokens per session (656 once invoked), scanned A, a copy of wacli, MIT.

A command-line tool for sending WhatsApp messages and searching or syncing WhatsApp history. A command-line tool is a program operated by typing commands in a terminal.

In plain words
What is it for?
Authenticating WhatsApp, finding chats, searching messages, syncing history, and sending text or files.
Why use it?
It helps automate WhatsApp tasks while requiring a clear recipient and message before sending.

Skill for Claude CodeCodex

Which agent this was written for is unclear — built for openclaw. Also seen: built for openclaw.

Good fit Authenticating WhatsApp, finding chats, searching messages, syncing history, and sending text or files.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/samttoo22-mewcat/opensoul/wacli
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add samttoo22-MewCat/OpenSoul --skill wacli
Clone the repo
git clone --depth 1 https://github.com/samttoo22-MewCat/OpenSoul

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for wacli

README.md
[![agentmods](https://agentmods.dev/badge/skills/samttoo22-mewcat/opensoul/wacli/github.svg)](https://agentmods.dev/skills/samttoo22-mewcat/opensoul/wacli)
Your own site
<a href="https://agentmods.dev/skills/samttoo22-mewcat/opensoul/wacli"><img src="https://agentmods.dev/badge/skills/samttoo22-mewcat/opensoul/wacli/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for wacli

Your own site · 80×15
<a href="https://agentmods.dev/skills/samttoo22-mewcat/opensoul/wacli"><img src="https://agentmods.dev/badge/skills/samttoo22-mewcat/opensoul/wacli.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 31 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 656 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 83% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00031 $0.00656
Opus 5 $0.00015 $0.00328
Sonnet 5 $0.00006 $0.00131
Haiku 4.5 $0.00003 $0.00066

Measured 8d ago against content hash e96ce8a145db, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

wacli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

83% identical to wacli — 6 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

openclaw/skills/wacli/SKILL.md · 73 lines

What it actually says

wacli

Use wacli only when the user explicitly asks you to message someone else on WhatsApp or when they ask to sync/search WhatsApp history. Do NOT use wacli for normal user chats; OpenClaw routes WhatsApp conversations automatically. If the user is chatting with you on WhatsApp, you should not reach for this tool unless they ask you to contact a third party.

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 "[email protected]" --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.
  • WhatsApp CLI is not needed for routine user chats; it’s for messaging other people.
  • JIDs: direct chats look like <number>@s.whatsapp.net; groups look like <id>@g.us (use wacli chats list to find).
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 73 lines · 31 tokens per session scan A e96ce8a145db

Subscribe to this mod's changes

wacli is a skill published in the GitHub repository samttoo22-MewCat/OpenSoul (19 stars, last pushed 5mo ago), licensed MIT. It adds 31 tokens to every session and 656 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. It is 83% identical to wacli, differing in 6 lines, and is treated as a copy.

Related

Other skills, from other repositories

meeting-note-summarizer

Turn meeting notes or transcripts into factual summaries, decisions, questions, and action items. Use when a user wants a concise recap or needs explicit owners and deadlines extracted without filling in missing details.

iflytek/skillhub · 44 tokens

daily-standup-journal

Generate concise daily standups, reflection prompts, and weekly retrospectives for individuals or teams. Use for planning a day, surfacing blockers, reviewing user-provided entries, or drafting a check-in without assuming prior history.

iflytek/skillhub · 51 tokens

ai-meeting-scheduling

Booking links fail for groups. SkipUp schedules meetings with 2-50 participants via email — one API call coordinates across timezones automatically. Also: check status, pause, resume, or cancel requests. Async only — does not instant-book, access calendars, or do free/busy lookups.

InternLM/WildClawBench · 66 tokens

03_task5

Triages a support inbox, prioritizes urgent issues, routes each to the right internal team member, and drafts any customer-facing replies for review. Use when: catching up on a backlog of support messages, producing an escalation report, or routing issues to appropriate owners.

InternLM/WildClawBench · 57 tokens

03_task2

Extracts action items and pending tasks from Slack messages. Use when: reviewing unread messages for todos, finding deadlines or requests directed at the user, or producing a task summary from recent Slack activity.

InternLM/WildClawBench · 43 tokens

pm-data

A workflow for defining product metrics, tracking events, monitoring results, and planning data analysis.

konglong87/superPM · 50 tokens