<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> warelay offers a robust solution for sending, receiving, and automating WhatsApp messages. It targets developers and power users integrating WhatsApp with external services or AI models like Claude, providing a flexible two-provider approach for custom automation workflows.

How It Works

The system utilizes two primary providers: Twilio for enterprise-grade messaging with delivery status and webhooks, and a personal WhatsApp Web provider via QR code login for rapid setup. An auto-reply engine supports static text or command execution, enabling AI-driven responses. Integration with Tailscale Funnel simplifies webhook deployment, allowing external triggers for WhatsApp actions.

Quick Start & Requirements

• Install: npm install -g warelay (requires Node.js v22+).
• Prerequisites: Node.js v22+, Twilio credentials (for Twilio provider), WhatsApp account (for Web provider, requires warelay login), Tailscale (for webhooks), Claude CLI (optional).
• Docs: Claude Setup Guide.

Highlighted Details

• Dual Providers: Seamless switching between Twilio (reliability, status) and personal Web (speed, ease).
• AI Integration: Auto-replies execute commands, integrating with AI CLIs like Claude for intelligent responses.
• One-Command Webhook: warelay webhook --ingress tailscale deploys a public webhook via Tailscale Funnel, auto-configuring Twilio callbacks.
• Media & Voice Notes: Supports sending various media types with automatic resizing/compression, and transcribing voice notes via external CLIs.
• Heartbeat Pings: Maintains AI session context by periodically pinging the AI model.
• Same-Phone Mode: Enables self-messaging with AI replies within the same chat bubble.

Maintenance & Community

Maintained by @steipete, the project is described as "brand-new." Community links beyond a Twitter handle are not specified.

Licensing & Compatibility

The license type is not specified in the provided README, a critical omission for adoption. Compatibility is primarily with Node.js environments.

Limitations & Caveats

As a "brand-new" project, expect potential instability or evolving features. Automation via the personal WhatsApp Web provider carries risks of rate-limiting or logouts. Session drops in the Web provider require manual re-login and do not automatically fall back to Twilio. The absence of a specified license is a significant adoption blocker.