steipete/whatsapp

Routeur WhatsApp : historique/recherche/lecture/envoi ; wacrawl en lecture, wacli en temps réel.

Qu'est-ce que whatsapp ?

Cette compétence offre un routage précis entre les deux outils principaux pour interagir avec WhatsApp : `wacrawl` (archive de bureau en lecture seule) et `wacli` (comptes liés en temps réel). Elle vous guide pour utiliser le bon outil selon le besoin : historique, recherche, lectures non lues, envoi, réactions, mutations de groupes, etc. La sécurité est primordiale : aucune mutation n'est effectuée sans demande explicite, et des drapeaux `--read-only` protègent les données. Idéale pour les développeurs qui doivent naviguer entre archives locales et comptes WhatsApp liés, cette compétence assure une couverture fiable sans risque de corruption.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/whatsapp

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait whatsapp ?

Utilisez ceci comme premier arrêt pour tout travail lié à WhatsApp. Maintenez une frontière nette entre les sources :

  • wacrawl : archive principale de WhatsApp Desktop. Lecture seule, meilleur historique local, sans réseau, sans envoi.
  • wacli : comptes d'appareils liés. À utiliser pour les comptes alternatifs, la synchronisation en direct, l'authentification, l'envoi, les mutations de discussions/groupes et les questions sur le protocole WhatsApp Web.

Si l'utilisateur mentionne spécifiquement wacrawl ou wacli comme travaux de dépôt, lisez également la compétence de cet outil.

Routage

  • Lectures principales WhatsApp / recherche / historique : utilisez wacrawl.
  • Comptes de messages lus/non lus depuis WhatsApp Desktop : utilisez wacrawl ; il possède des comptes de non lus par discussion, pas d'état de lecture par message.
  • Lectures principales sensibles à la fraîcheur : vérifiez wacrawl status ; exécutez wacrawl sync sur demande ou lorsque les données actuelles comptent.
  • Comptes alternatifs comme me, molty ou des magasins nommés : utilisez wacli --account NOM.
  • Envoi, réactions, présence, archivage/épinglage/sourdine/marquer-lu, mutations de groupes/canaux : utilisez wacli seulement après une intention explicite de l'utilisateur.
  • Comparaison de couverture entre sources : traitez wacrawl comme la vérité de l'archive Desktop pour l'historique principal, et wacli comme la couverture en direct/appareil lié avec les limites du protocole.

Sécurité

  • N'envoyez jamais et ne mutez jamais l'état de WhatsApp sauf demande explicite.
  • Préférez les commandes wacli en lecture seule pour l'inspection : passez --read-only ou définissez WACLI_READONLY=1.
  • N'écrivez pas dans le conteneur d'application de WhatsApp Desktop.
  • Ne modifiez pas directement session.db de wacli.
  • Gardez les comptes wacli nommés isolés ; ne fusionnez pas les magasins.
  • Rapportez la fraîcheur de la source, le nom du compte et les lacunes connues lorsque vous répondez depuis les magasins locaux.

Commandes Courantes

Archive Principale

Fraîcheur et statut :

wacrawl status
wacrawl doctor
wacrawl sync

Tri des non lus :

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

Recherche et tranches de messages :

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

Médias ou sauvegardes d'archive, seulement sur demande :

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

Comptes Alternatifs/En Direct

Découverte de comptes et inspection en lecture seule :

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"

Synchronisation en direct en arrière-plan, seulement sur demande. Préférez tmux pour le mode suivi :

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

Médias, envoi et mutations en direct, seulement sur demande explicite :

wacli --account me media download --chat JID --id MESSAGE_ID
wacli --account me send text --to JID_OR_NAME --message "message"
wacli --account me send file --to JID_OR_NAME --file ./file.jpg --caption "caption"
wacli --account me send text --to JID --reply-to MESSAGE_ID --message "reply"

Comparaisons

Lors de la comparaison de wacrawl et wacli, comparez les deux comptes et leur chevauchement :

  • nombres de messages et plages de dates
  • nombres de discussions
  • horodatage du message le plus récent
  • chevauchement par msg_id
  • chevauchement par chat_jid + msg_id lorsque les JID sont suffisamment normalisées
  • lacunes évidentes expliquées par les limites d'historique des appareils liés par rapport à la couverture de l'archive Desktop

Pointeurs de Dépôt

  • ~/Projects/wacrawl : importateur/recherche/sauvegarde d'archive Desktop.
  • ~/Projects/wacli : client/appareil lié/synchronisation/envoi.
  • Copies globales de compétences : ~/Projects/agent-scripts/skills/wacrawl et ~/Projects/agent-scripts/skills/wacli.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Skills associés