Skip to content

WhatsApp Router

Routes WhatsApp reads, searches and sends to the right local archive or live account tool

Stars
7,433
Licence
MIT
Files
1 file

What it does

This skill acts as a traffic controller for WhatsApp tasks. It tells the agent which of two command-line tools to use: wacrawl for searching and reading a local archive of WhatsApp Desktop history, and wacli for linked-device accounts, live sync and sending. It sets safety rules, such as never sending messages unless explicitly asked, using read-only modes by default, and reporting data freshness and account names.

Great for

  • People who already use the wacrawl or wacli command-line tools and want an agent to query their WhatsApp history
  • Users who manage several WhatsApp accounts and need them kept separate
  • Developers comparing message coverage between WhatsApp Desktop and linked-device stores

Skip it if

  • Anyone without the wacrawl or wacli tools installed, since the skill only routes to them and does not provide them
  • Automated or unattended message sending, because the skill requires explicit user intent before any send, reaction or group change
  • Privacy-sensitive situations where reading personal chat history by an agent is not wanted, because the commands expose full message content

Try asking

  • “Show me unread WhatsApp chats from the last day”
  • “Search my WhatsApp Desktop history for messages about the invoice from 2026”
  • “Check the status of my alt account 'molty' and list its recent chats read-only”
  • “Compare message counts between wacrawl and wacli for my primary account”
Step-by-step guide: how to use WhatsApp RouterInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    whatsapp.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip whatsapp.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip whatsapp.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask for read-only inspection first; the skill defaults to --read-only and only sends when you explicitly request it
  • Name the account (for example 'me' or 'molty') so the agent keeps stores isolated and reports the correct source
  • Ask the agent to run wacrawl status before answering, so you know how fresh the local archive is

What's inside

  • SKILL.md

Redistributed unmodified from steipete/agent-scripts under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.