whatsapp

---
name: whatsapp
description: "Use when working with whatsApp router: history/search/read/send; wacrawl read, wacli live from steipete/agent-scripts."
source: https://github.com/steipete/agent-scripts/tree/main/skills/whatsapp
generated: 2026-05-27T20:56:54.010Z
category: tool
audience: general
---

## When to use

- Use this as the first stop for WhatsApp work. Keep the source boundary sharp:.
- Using the whatsapp skill's upstream workflow, guardrails, and local-tool assumptions.
- Auditing commands or operational steps before changing whatsapp behavior.
- Needing a compact agent reference for whatsApp router: history/search/read/send; wacrawl read, wacli live.

## Key concepts

### Routing

Primary WhatsApp reads/search/history: use wacrawl. Read/unread counts from WhatsApp Desktop: use wacrawl; it has chat-level unread counts, not per-message read state. Freshness-sensitive primary reads: check wacrawl status; run wacrawl sync when asked or when current data matters. Alt accounts such as me, molty, or named stores: use wacli --account NAME. Sending, reactions, presence, archive/pin/mute/mark-read, group/channel mutations: use wacli only after explicit user intent. Comparing...

### Safety

Never send or mutate WhatsApp state unless explicitly requested. Prefer read-only wacli commands for inspection: pass --read-only or set WACLIREADONLY=1. Do not write into WhatsApp Desktop's app container. Do not edit wacli session.db directly. Keep named wacli accounts isolated; do not merge stores. Report source freshness, account name, and known gaps when answering from local stores.

### Common Commands

Common Commands guidance for the whatsapp skill.

### Primary Archive

Freshness and status: Unread triage: Search and slice messages: Archive media or backups, only when asked:.

### Alt/Live Accounts

Account discovery and read-only inspection: Background live sync, only when requested. Prefer tmux for follow-mode: Media, sending, and live mutations, only when explicitly requested:.

### Comparisons

When comparing wacrawl and wacli, compare both counts and overlap: message counts and date spans chat counts newest message timestamp overlap by msgid overlap by chatjid + msgid when JIDs are normalized enough obvious gaps explained by linked-device history limits vs Desktop archive coverage.

## API reference

```
npx skills add steipete/agent-scripts --skill whatsapp
```

Install the whatsapp skill from steipete/agent-scripts.

```
npx skills add steipete/agent-scripts --skill whatsapp
```

```
wacrawl status.
```

Command or snippet documented by the upstream whatsapp skill.

```
wacrawl status
wacrawl doctor
wacrawl sync
```

```
wacrawl chats --limit 20.
```

Command or snippet documented by the upstream whatsapp skill.

```
wacrawl chats --limit 20
wacrawl unread --limit 20
wacrawl --json unread --limit 100
```

```
wacrawl messages --after 2026-01-01 --limit 50.
```

Command or snippet documented by the upstream whatsapp skill.

```
wacrawl messages --after 2026-01-01 --limit 50
wacrawl messages --chat JID --asc --limit 100
wacrawl messages --has-media --limit 50
wacrawl --json search "query"
wacrawl search "query" --after 2026-01-01 --from-them
```

```
wacrawl import --copy-media.
```

Command or snippet documented by the upstream whatsapp skill.

```
wacrawl import --copy-media
wacrawl backup status
wacrawl --sync never backup push
```

```
wacli accounts list --json.
```

Command or snippet documented by the upstream whatsapp skill.

```
wacli accounts list --json
wacli --account me auth status --read-only --json
wacli --account me chats list --read-only --json
wacli --account me messages list --read-only --json --limit 50
wacli --account me messages search --read-only --json "query"
```

```
wacli --account me sync --follow --events.
```

Command or snippet documented by the upstream whatsapp skill.

```
wacli --account me sync --follow --events
wacli --account me sync --once --events
```

## Gotchas

- Never send or mutate WhatsApp state unless explicitly requested.
- Prefer read-only wacli commands for inspection: pass --read-only or set WACLIREADONLY=1.
- Do not write into WhatsApp Desktop's app container.
- Do not edit wacli session.db directly.

---
Generated by SkillMake from https://github.com/steipete/agent-scripts/tree/main/skills/whatsapp on 2026-05-27T20:56:54.010Z.
Verify against source before relying on details.

File: ~/.claude/skills/whatsapp/SKILL.md