How dsebastien/whatsapp-claude-agent works
WhatsApp Claude Agent accepts phone and group messages, filters them through whitelist/targeting rules, routes commands or conversation prompts, invokes Claude Code in a configured working directory, and sends responses back over WhatsApp. The graph captures CLI/configuration, messaging, conversation state, and Claude execution; several links rely on the SOURCE INDEX or README because implementation excerpts are partial.
Main entry points: client.ts WhatsApp client · manager.ts Conversation manager · index.ts Runtime orchestrator · backend.ts Claude backend
Components 21
Startup and configuration
- CLI commands
src/cli/commands.ts - Configuration
src/cli/config.ts - Config commands
src/cli/config-commands.ts - Agent identity
src/utils/agent-name.ts - Runtime orchestrator
src/index.ts
WhatsApp messaging
- WhatsApp client
src/whatsapp/client.ts - WhatsApp network
- Auth persistence
src/whatsapp/auth.ts - Message parsing
src/whatsapp/messages.ts - Response chunking
src/whatsapp/chunker.ts - Phone filtering
src/utils/phone.ts
Conversation workflow
- Conversation manager
src/conversation/manager.ts - Conversation history
src/conversation/history.ts - Message queue
src/conversation/queue.ts
Claude execution
- Claude backend
src/claude/backend.ts - SDK backend
src/claude/sdk-backend.ts - Permission modes
src/claude/permissions.ts - Model selection
src/claude/utils.ts
Other components
- WhatsApp user
- Working files
- Claude Agent SDK
Connections 27
- WhatsApp user → WhatsApp network: sends messages
README.md - WhatsApp network → WhatsApp client: delivers events
src/whatsapp/client.ts - WhatsApp client → Auth persistence: loads session
src/whatsapp/client.ts - WhatsApp client → Message parsing: parses incoming
src/whatsapp/client.ts - WhatsApp client → Phone filtering: checks whitelist
src/whatsapp/client.ts - WhatsApp client → Runtime orchestrator: emits events
src/index.ts - Runtime orchestrator → CLI commands: parses options
src/index.ts - CLI commands → Configuration: loads configuration
src/cli/commands.ts - CLI commands → Config commands: registers subcommand
src/cli/commands.ts - Configuration → Agent identity: generates identity
src/cli/config.ts - Runtime orchestrator → WhatsApp client: creates client
src/index.ts - Runtime orchestrator → Claude backend: creates SDK backend
src/index.ts - Runtime orchestrator → Conversation manager: creates manager
src/index.ts - Runtime orchestrator → Conversation manager: routes messages
src/index.ts - Conversation manager → Message parsing: parses commands
src/conversation/manager.ts - Conversation manager → Agent identity: checks group targeting
src/conversation/manager.ts - Conversation manager → Conversation history: updates history
src/conversation/manager.ts - Conversation manager → Message queue: uses queue
src/conversation/manager.ts - Conversation manager → Claude backend: submits prompts
src/conversation/manager.ts - Claude backend → Model selection: resolves model
src/claude/backend.ts - Claude backend → SDK backend: implements backend
src/claude/sdk-backend.ts - SDK backend → Claude Agent SDK: runs queries
src/claude/sdk-backend.ts - SDK backend → Permission modes: applies modes
- Claude Agent SDK → Working files: acts on files
README.md - Conversation manager → WhatsApp client: sends responses
src/conversation/manager.ts - WhatsApp client → Response chunking: splits responses
src/whatsapp/client.ts - WhatsApp client → WhatsApp network: sends messages