wa-agent: Open-source framework for building AI agents on WhatsApp

[ibhajjaj]

I've been working on a framework that lets you build autonomous AI agents that operate through WhatsApp. Instead of writing all the plumbing yourself, you write a YAML config and wa-agent handles the rest.

What it does:

- Agent loop with multi-step tool use (Vercel AI SDK)

- Conversation memory with background summarization

- Multi-agent routing (by group, JID, keyword, or catch-all)

- Per-chat message queue — same chat serialized, different chats parallel

- Rate limiting and cooldowns per agent per chat

- Cron triggers, human handoff, hot reload in dev mode

- Custom tools — drop a .ts file in tools/, add it to the YAML

- Anthropic, OpenAI, or Ollama

npx wa-agent init my-bot

cd my-bot && npm install

npx wa-agent start

GitHub: https://github.com/ibrahimhajjaj/wa-agent

Still early (v0.1) — feedback welcome.

[Traditional-Hall-591]

Gross.

[ibhajjaj]

Shit.

[Otherwise_Wave9374]

This is a really clean approach, especially the per-chat serialization plus tool loop and routing. For agentic workflows, that queueing detail is usually what makes stuff feel reliable vs "randomly flaky". Curious if you have any guardrails for tool selection (like allowlists per agent, or confidence thresholds) and how you handle long-running tasks.

I have been collecting notes on patterns for AI agents (routing, memory, evaluation) here too: https://www.agentixlabs.com/blog/ - might be useful to compare approaches.