Wacon

Tu WhatsApp, tu terminal, tus agentes de IA.

Lee conversaciones, organiza pendientes y prepara respuestas con memoria por contacto.

Instalación · Primeros pasos · Conectar un agente · Configuración · Desarrollo

El almacenamiento y el análisis básico funcionan en tu equipo. Las integraciones con modelos, voz y NotebookLM son opcionales.

Qué puedes hacer

Related MCP server: WhatsApp MCP Server (TypeScript)

Instalación

Requiere Node.js 22.18.0 o superior, npm y una cuenta de WhatsApp para vincular el dispositivo.

Desde npm

npm install -g @josetra/wacon
wacon --version

El paquete se llama @josetra/wacon; el comando instalado es wacon.

También puedes ejecutarlo sin instalación global:

npx -y @josetra/wacon login

Desde GitHub

Disponible para instalar directamente desde el código fuente:

npm install -g github:JOSETRA44/wacon-mcp

Esta vía requiere Git y compila el proyecto durante la instalación. Wacon incluye dependencias nativas; si no hay un binario precompilado compatible con tu plataforma, la instalación puede requerir herramientas de compilación de C++.

Primeros pasos

1. Vincula tu cuenta.

wacon login

En WhatsApp, abre Dispositivos vinculados → Vincular un dispositivo y escanea el QR de la terminal.

2. Comprueba la conexión y explora tus conversaciones.

wacon status
wacon chats
wacon inbox

3. Abre el cliente que prefieras.

wacon chat          # Chat ligero
wacon chat ultra    # Interfaz de pantalla completa
wacon tui           # Alias de la interfaz de pantalla completa

4. Construye tu memoria de conversación.

Cuando el historial esté sincronizado:

wacon init          # Analiza contactos
wacon init --all    # Incluye grupos
wacon persona      # Consulta tu perfil global

Revisa y edita ~/.wacon/persona.md: define tu voz y las reglas que deben seguir los agentes. Los hechos extraídos automáticamente son candidatos de baja confianza; conviene revisarlos antes de usarlos como contexto.

Conectar un agente

Claude Code

Con Wacon instalado globalmente:

claude mcp add wacon -- wacon mcp

O usando npx:

claude mcp add wacon -- npx -y @josetra/wacon mcp

Otros clientes MCP

Añade una entrada equivalente a la configuración de tu cliente:

{
  "mcpServers": {
    "wacon": {
      "command": "npx",
      "args": ["-y", "@josetra/wacon", "mcp"]
    }
  }
}

El formato exacto depende del cliente. Si en Windows necesita ejecutar npx a través del intérprete de comandos, utiliza "command": "cmd" y "args": ["/c", "npx", "-y", "@josetra/wacon", "mcp"].

También existe un endpoint HTTP local en http://127.0.0.1:8317/mcp. Requiere Authorization: Bearer <token>; el token de la sesión está en ~/.wacon/daemon.json.

Skills incluidas

El paquete contiene dos guías para agentes:

• wacon-whatsapp: conversaciones, respuestas, archivos y seguimiento.

• wacon-knowledge: análisis, perfiles, hechos y memoria episódica.

wacon skills                   # Instala las skills sin sobrescribir las existentes
wacon skills --force           # Actualiza las copias instaladas
wacon skills --target ./skills # Elige otro destino

Durante la instalación, Wacon intenta copiarlas a ~/.claude/skills/ si ya existe la configuración de Claude. Puedes omitir este paso con la variable de entorno WACON_SKIP_POSTINSTALL=1; también se omite en CI. El destino predeterminado se puede cambiar mediante WACON_SKILLS_DIR.

Uso cotidiano

Leer, buscar y responder

wacon contacts "Contacto"
wacon read "Contacto" --limit 20
wacon search "reunión"
wacon send "Contacto" "Confirmado, nos vemos a las cinco."

Los comandos de envío actúan sobre WhatsApp. Para ensayar sin enviar, activa dryRun en la configuración.

Revisar pendientes

wacon inbox
wacon brief
wacon commitments
wacon calendar --days 7
wacon tasks

Los compromisos y las sugerencias se extraen del historial; revísalos antes de tratarlos como acuerdos confirmados.

Analizar y recordar

wacon init --groups
wacon profile "Contacto"
wacon facts "Contacto"
wacon suggested
wacon suggested --confirm 12

Las sugerencias de eventos no se incorporan automáticamente a tu agenda: debes confirmarlas.

Archivos, stickers y voz

Dentro del chat ligero:

/send ./informe.pdf Aquí está el informe.
/send ./nota.ogg --voz
/voz Confirmado, nos vemos a las cinco.

Desde la terminal:

wacon stickers --sync
wacon voice "Contacto" "Confirmado, nos vemos a las cinco."

La síntesis de voz requiere un backend configurado. Los agentes disponen de herramientas como send_file, send_sticker y send_voice_message.

Seguimiento y automatización

wacon watch --minutes 30 --min-priority 40
wacon digest --minutes 60
wacon inbox --json

Para scripts y agentes, los comandos de datos admiten --json y evitan los códigos de color. Las herramientas MCP wait_for_messages y wait_for_triggers permiten esperar novedades y recordatorios. El daemon notifica los eventos; el agente decide cómo actuar.

Consulta todas las opciones con wacon --help o wacon <comando> --help.

Cómo funciona la memoria

Wacon combina tres fuentes de contexto:

La recuperación local combina búsqueda de texto, similitud por n-gramas y recencia. No necesita un servicio externo de embeddings. El análisis inicial usa reglas y estadísticas; un agente puede enriquecer o corregir sus resultados.

La herramienta MCP prepare_reply reúne el perfil, los hechos y el contexto relevante para preparar una respuesta.

Configuración

El directorio predeterminado es ~/.wacon/ (%USERPROFILE%\.wacon\ en Windows). Puedes cambiarlo con WACON_HOME.

~/.wacon/
├── auth/          Credenciales de la sesión de WhatsApp
├── profiles/      Perfiles por contacto
├── wacon.db       Mensajes, hechos y agenda
├── persona.md     Tu voz y reglas para agentes
├── config.json    Preferencias y límites
├── notebooks.json Asociaciones con NotebookLM
└── daemon.json    Información de conexión local

Ejemplo de config.json para probar los flujos sin realizar envíos:

{
  "dryRun": true,
  "sendRateLimitPerMinute": 10,
  "allowedChats": [],
  "blockedChats": [],
  "daemonPort": 8317
}

• dryRun: registra los intentos de envío sin enviarlos. Su valor predeterminado es false.

• allowedChats: si contiene JIDs, limita los envíos a esos chats.

• blockedChats: impide enviar a los JIDs indicados.

• sendRateLimitPerMinute: limita la frecuencia de envío.

Integraciones opcionales

Estas integraciones se configuran según el proveedor que utilices. Las API externas pueden tener coste y recibir el contenido que les envíes. Sin una API de visión o transcripción configurada, las herramientas MCP pueden entregar imágenes o audio al cliente para que use sus propias capacidades multimodales.

Arquitectura y privacidad

Terminal / cliente MCP
          │
          ▼
   Daemon local de Wacon
          ├── Sesión de WhatsApp mediante Baileys
          ├── SQLite: mensajes, memoria y agenda
          ├── Perfiles Markdown
          └── Integraciones opcionales

El daemon comparte una sesión entre clientes, escucha en 127.0.0.1 y requiere un token de acceso. Los mensajes, perfiles y análisis se almacenan localmente. Al conectar un agente o habilitar un servicio externo, el contenido solicitado puede ser procesado por ese cliente o proveedor.

Las credenciales de WhatsApp se guardan en el directorio auth/ sin cifrado adicional de Wacon. Protege ese directorio y no lo incluyas en repositorios ni archivos compartidos.

Diagnóstico

wacon doctor
wacon errors --tail 20
wacon daemon log

wacon doctor comprueba el estado local y las integraciones. Para reiniciar el daemon puedes usar wacon daemon-restart. Si necesitas volver a vincular la cuenta, revisa primero el diagnóstico y luego ejecuta wacon login.

Desarrollo

git clone https://github.com/JOSETRA44/wacon-mcp.git
cd wacon-mcp
npm ci
npm run check
npm link

Las notas de arquitectura y diseño están en wacon-docs. Para preparar una versión y configurar la publicación, consulta la guía de releases.

Para reportar un problema, incluye la versión de Wacon, Node.js, el sistema operativo y los pasos para reproducirlo en Issues. Elimina teléfonos, mensajes privados, tokens y credenciales de los registros que compartas.

Proyecto y licencia

Wacon es un proyecto independiente que usa Baileys para integrarse con WhatsApp. No es una aplicación oficial ni está afiliada a WhatsApp o Meta; el uso de clientes no oficiales puede afectar la disponibilidad de la cuenta.

Publicado bajo la licencia MIT. Los stickers incluidos derivan de Twemoji, con licencia CC BY 4.0; su atribución se conserva en el manifest del pack.