Skip to content

Commit b54548f

Browse files
grokifyclaude
andcommitted
docs: update documentation for new providers
- README: Add Slack and Gmail to supported platforms - TASKS: Expand roadmap with multi-tenancy, webhook, SMS items - Add gmail-setup.md and slack-setup.md guides - Update configuration.md with new options - Update mkdocs.yml navigation Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 8f35e59 commit b54548f

File tree

7 files changed

+764
-44
lines changed

7 files changed

+764
-44
lines changed

README.md

Lines changed: 32 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727

2828
**[Documentation](https://plexusone.github.io/agentcomms/)** | **[Getting Started](https://plexusone.github.io/agentcomms/getting-started/)** | **[MCP Tools](https://plexusone.github.io/agentcomms/mcp-tools/)**
2929

30-
An MCP plugin that enables voice calls and chat messaging for AI coding assistants. Start a task, walk away. Your phone rings when the AI is done, stuck, or needs a decision. Or get notified via Discord, Telegram, or WhatsApp.
30+
An MCP plugin that enables voice calls and chat messaging for AI coding assistants. Start a task, walk away. Your phone rings when the AI is done, stuck, or needs a decision. Or get notified via Discord, Slack, Telegram, WhatsApp, or Gmail.
3131

3232
**Supports:** Claude Code, AWS Kiro CLI, Gemini CLI
3333

@@ -36,7 +36,7 @@ An MCP plugin that enables voice calls and chat messaging for AI coding assistan
3636
## Features
3737

3838
- 📞 **Phone Calls**: Real voice calls to your phone via Twilio—works with smartphones, smartwatches, landlines, or VoIP
39-
- 💬 **Chat Messaging**: Send messages via Discord, Telegram, or WhatsApp
39+
- 💬 **Chat Messaging**: Send messages via Discord, Slack, Telegram, or WhatsApp
4040
- 🔄 **Multi-turn Conversations**: Back-and-forth discussions, not just one-way notifications
4141
-**Smart Triggers**: Hooks that suggest calling/messaging when you're stuck or done with work
4242
- 🔀 **Mix and Match**: Use voice, chat, or both based on your needs
@@ -90,31 +90,31 @@ AgentComms provides **bidirectional communication** between humans and AI agents
9090
## Architecture
9191

9292
```
93-
┌───────────────────────────────────────────────────────────────────────────┐
94-
│ AgentComms │
95-
├───────────────────────────────────────────────────────────────────────────┤
96-
│ OUTBOUND (MCP Server) - Agent → Human │
97-
│ ├── Voice Tools: initiate_call, continue_call, speak_to_user, end_call
98-
│ ├── Chat Tools: send_message, list_channels, get_messages
99-
│ ├── Voice Manager - Orchestrates calls via omnivoice │
100-
│ └── Chat Manager - Routes messages via omnichat │
101-
├───────────────────────────────────────────────────────────────────────────┤
102-
│ INBOUND (Daemon) - Human → Agent │
103-
│ ├── Router - Actor-style event dispatcher (goroutine per agent) │
104-
│ ├── AgentBridge - Adapters for tmux, process, etc. │
105-
│ ├── Event Store - SQLite database via Ent ORM │
106-
│ └── Transports - Discord, Twilio (receives human messages) │
107-
├───────────────────────────────────────────────────────────────────────────┤
108-
│ Shared Infrastructure │
109-
│ ├── omnivoice - Voice abstraction (TTS, STT, Transport, CallSystem) │
110-
│ ├── omnichat - Chat abstraction (Discord, Telegram, WhatsApp) │
111-
│ ├── mcpkit - MCP server with ngrok integration │
112-
│ └── Ent - Database ORM with SQLite/PostgreSQL support │
113-
├───────────────────────────────────────────────────────────────────────────┤
114-
│ Provider Implementations │
115-
│ ├── Voice: ElevenLabs, Deepgram, OpenAI, Twilio
116-
│ └── Chat: Discord, Telegram, WhatsApp
117-
└───────────────────────────────────────────────────────────────────────────┘
93+
┌─────────────────────────────────────────────────────────────────────────────
94+
AgentComms │
95+
├─────────────────────────────────────────────────────────────────────────────
96+
│ OUTBOUND (MCP Server) - Agent → Human
97+
│ ├── Voice Tools - initiate_call, continue_call, speak_to_user, end_call │
98+
│ ├── Chat Tools - send_message, list_channels, get_messages │
99+
│ ├── Voice Manager - Orchestrates calls via omnivoice
100+
│ └── Chat Manager - Routes messages via omnichat
101+
├─────────────────────────────────────────────────────────────────────────────
102+
│ INBOUND (Daemon) - Human → Agent
103+
│ ├── Router - Actor-style event dispatcher (goroutine per agent)
104+
│ ├── AgentBridge - Adapters for tmux, process, etc.
105+
│ ├── Event Store - SQLite database via Ent ORM
106+
│ └── Transports - Discord, Twilio (receives human messages)
107+
├─────────────────────────────────────────────────────────────────────────────
108+
│ Shared Infrastructure
109+
│ ├── omnivoice - Voice abstraction (TTS, STT, Transport, CallSystem)
110+
│ ├── omnichat - Chat abstraction (Discord, Telegram, WhatsApp)
111+
│ ├── mcpkit - MCP server with ngrok integration
112+
│ └── Ent - Database ORM with SQLite/PostgreSQL support
113+
├─────────────────────────────────────────────────────────────────────────────
114+
│ Provider Implementations
115+
│ ├── Voice - ElevenLabs, Deepgram, OpenAI, Twilio
116+
│ └── Chat - Discord, Slack, Telegram, WhatsApp, Gmail
117+
└─────────────────────────────────────────────────────────────────────────────
118118
```
119119

120120
## The plexusone Stack
@@ -137,7 +137,7 @@ This project demonstrates the plexusone voice and chat AI stack:
137137

138138
- Go 1.25+
139139
- For voice: Twilio account + ngrok account
140-
- For chat: Discord/Telegram bot token (optional)
140+
- For chat: Discord/Slack/Telegram bot token (optional)
141141

142142
### Build
143143

@@ -162,6 +162,8 @@ AgentComms uses a unified JSON configuration file that combines all settings.
162162

163163
# Set environment variables for secrets
164164
export DISCORD_TOKEN=your_discord_bot_token
165+
export SLACK_BOT_TOKEN=xoxb-your-bot-token
166+
export SLACK_APP_TOKEN=xapp-your-app-token
165167
export TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
166168
export TWILIO_AUTH_TOKEN=your_auth_token
167169
export ELEVENLABS_API_KEY=your_elevenlabs_key
@@ -667,7 +669,8 @@ agentcomms/
667669
| Deepgram STT | ~$0.0043/min (Nova-2) |
668670
| OpenAI TTS | ~$0.015/1K chars |
669671
| OpenAI STT | ~$0.006/min (Whisper) |
670-
| Discord/Telegram | Free |
672+
| Discord/Telegram/Slack | Free |
673+
| Gmail API | Free (500 emails/day) |
671674
| ngrok (free tier) | $0 |
672675

673676
**Provider Recommendations:**

0 commit comments

Comments
 (0)