WireCatLabs/whatsapp-cli

Your personal WhatsApp in the terminal, searchable on your computer, and ready for Claude Code,
Codex, Cursor or any agent — within limits you set.
Docs ·
Examples ·
WireCat
An example conversation (invented people, illustrative output):
text
You: Use wa CLI. Who is waiting for my answer since yesterday?
Agent: (runs wa personal review 'date>1d' --unanswered: 3 chats)
· Alice Example asked about Saturday's table, 18:40 yesterday
· "Book club" — Bob Sample asked who brings the next book
You: Tell Alice: yes, 8 pm.
Agent: Draft to Alice Example: "Yes, 8 pm." Send it?
You: Yes.
> ⚠️ wa is an unofficial client of your real WhatsApp account. WhatsApp's terms forbid unofficial clients, and
> WhatsApp may ban an account that uses one. It also bans accounts that send in bulk or write to people who do not
> know them. wa writes only when a command asks, sends at most 30 messages an hour by default, and holds every
> write when WhatsApp says to slow down or restricts the account. Do not send in bulk, and do not write to strangers.
> You use wa at your own risk. More: limits
Early. wa is new, and some of what it does has not yet been checked against real WhatsApp. The
backlog lists the checks still to run.
More: compared with other tools · on wirecat.dev
## Quick start
sh
npm install -g @wirecat/whatsapp-cli
wa personal setup --agent claude # also codex, cursor, gemini, all or none
wa personal server install # keep receiving in the background
wa personal inbox # other people's unread messages; nothing is marked read
Allow about five minutes. wa personal setup links wa to your account as a device — you scan a QR code in
WhatsApp → Settings → Linked devices — keeps the history your phone sends right after linking, checks your first
chats and installs the agent skill.
It needs Node 22.16+ or 24+ on macOS, Linux or Windows. npm also installs the engine, the small program that
speaks WhatsApp's protocol, as a separate package for your system.
More: installation guide · linking
## What can you do?
Catch up. "Use wa CLI. What came in since this morning, and who is waiting for my answer?"
sh
wa personal inbox
wa personal review 'date>1d' --unanswered
Find anything. "Use wa CLI. When did we agree on the venue with Alice?" — an answer with the date and the
message itself.
sh
wa personal search all "venue" # messages and notes kept on this computer
Keep your promises. "Use wa CLI. What did I promise, and what am I still waiting on?"
sh
wa personal review --new # what changed since the last review --new
wa personal tasks list state:open
Run your groups. "Use wa CLI. Which questions in Hiking has nobody answered?"
sh
wa personal review chat:Hiking --unanswered
wa personal chats events Hiking 'time>=7d' # who joined, left, was added or removed
Answer, when you say so.
sh
wa personal messages send "Book club" "Call at 3?" --reply-to 3EB0A1B2C3D4E5F6A7B8
wa personal messages edit "Book club" 3EB0A1B2C3D4E5F6A7B8 "Call at 4?" # your own, within 20 minutes
wa personal reactions add "Book club" 3EB0A1B2C3D4E5F6A7B8 👍
wa personal messages delete "Book club" 3EB0A1B2C3D4E5F6A7B8 --for-everyone
wa personal chats mark-read "Book club" # the other side sees it