steipete/whatsapp

Enrutador de WhatsApp: historial/búsqueda/lectura/envío; wacrawl solo lectura, wacli en vivo.

¿Qué es whatsapp?

Esta habilidad proporciona una interfaz unificada para trabajar con WhatsApp, distinguiendo claramente entre dos fuentes complementarias: `wacrawl`, que es un archivo de solo lectura del escritorio de WhatsApp con el mejor historial local (sin red, sin envío), y `wacli`, que permite cuentas de dispositivo vinculado para sincronización en vivo, autenticación, envío y mutaciones de chats/grupos. Es útil para desarrolladores que necesitan buscar mensajes históricos, revisar mensajes no leídos, enviar mensajes o administrar cuentas alternativas de manera segura. La habilidad enfatiza la seguridad: no muta estado a menos que el usuario lo solicite explícitamente y recomienda comandos de solo lectura para inspección. Incluye comandos comunes para actualizar el archivo, buscar mensajes, administrar cuentas en vivo, descargar medios y comparar cobertura entre `wacrawl` y `wacli`.

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

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace whatsapp?

Utiliza esto como primera parada para trabajo con WhatsApp. Mantén clara la separación de fuentes:

  • wacrawl: archivo principal de WhatsApp Desktop. Solo lectura, mejor historial local, sin red, sin envío.
  • wacli: cuentas de dispositivo vinculado. Úsalo para cuentas alternativas, sincronización en vivo, autenticación, envío, mutaciones de chats/grupos y preguntas sobre el protocolo de WhatsApp Web.

Si el usuario menciona trabajo específico con los repositorios wacrawl o wacli, lee también la habilidad propia de esa herramienta.

Enrutamiento

  • Lecturas/búsquedas/historial principal de WhatsApp: usa wacrawl.
  • Conteos de leídos/no leídos de WhatsApp Desktop: usa wacrawl; tiene conteos de no leídos a nivel de chat, no estado de lectura por mensaje.
  • Lecturas principales sensibles a frescura: verifica wacrawl status; ejecuta wacrawl sync cuando se solicite o cuando los datos actuales importen.
  • Cuentas alternativas como me, molty o almacenes nombrados: usa wacli --account NOMBRE.
  • Envío, reacciones, presencia, archivar/fijar/silenciar/marcar como leído, mutaciones de grupos/canales: usa wacli solo después de una intención explícita del usuario.
  • Comparación de cobertura entre fuentes: trata wacrawl como la verdad del archivo de escritorio para el historial principal, y wacli como cobertura de dispositivo vinculado/en vivo con límites de protocolo.

Seguridad

  • Nunca envíes ni mutes el estado de WhatsApp a menos que se solicite explícitamente.
  • Prefiere comandos de solo lectura de wacli para inspección: pasa --read-only o establece WACLI_READONLY=1.
  • No escribas dentro del contenedor de la aplicación de WhatsApp Desktop.
  • No edites session.db de wacli directamente.
  • Mantén las cuentas nombradas de wacli aisladas; no combines almacenes.
  • Reporta frescura de la fuente, nombre de la cuenta y brechas conocidas al responder desde almacenes locales.

Comandos Comunes

Archivo Principal

Frescura y estado:

wacrawl status
wacrawl doctor
wacrawl sync

Triaje de no leídos:

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

Buscar y segmentar mensajes:

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

Archivar medios o copias de seguridad, solo cuando se solicite:

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

Cuentas Alternativas/En Vivo

Descubrimiento de cuentas e inspección de solo lectura:

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 "consulta"

Sincronización en vivo en segundo plano, solo cuando se solicite. Prefiere tmux para modo de seguimiento:

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

Medios, envío y mutaciones en vivo, solo cuando se solicite explícitamente:

wacli --account me media download --chat JID --id ID_MENSAJE
wacli --account me send text --to JID_O_NOMBRE --message "mensaje"
wacli --account me send file --to JID_O_NOMBRE --file ./archivo.jpg --caption "título"
wacli --account me send text --to JID --reply-to ID_MENSAJE --message "respuesta"

Comparaciones

Al comparar wacrawl y wacli, compara ambos conteos y superposición:

  • conteos de mensajes y rangos de fechas
  • conteos de chats
  • marca de tiempo del mensaje más reciente
  • superposición por msg_id
  • superposición por chat_jid + msg_id cuando los JIDs están suficientemente normalizados
  • brechas obvias explicadas por límites de historial de dispositivo vinculado frente a cobertura del archivo de escritorio

Referencias a Repositorios

  • ~/Projects/wacrawl: importador/búsqueda/copia de seguridad del archivo de escritorio.
  • ~/Projects/wacli: cliente/sincronización/envío de dispositivo vinculado.
  • Copias globales de habilidades: ~/Projects/agent-scripts/skills/wacrawl y ~/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 relacionados