From 1d55c45e7e2dfa27f3b6c4fad04d9669c354729d Mon Sep 17 00:00:00 2001
From: Ben Vinegar <2153+benvinegar@users.noreply.github.com>
Date: Mon, 23 Feb 2026 09:24:34 -0500
Subject: [PATCH 1/2] Explain Slack broker

---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/README.md b/README.md
index 8781352..ff441bf 100644
--- a/README.md
+++ b/README.md
@@ -74,6 +74,12 @@ Upgrade later:
 sudo baudbot update
 ```
 
+Connect/talk to the control agent:
+
+```
+sudo baudbot attach
+```
+
 Install with a specific pi version (optional):
 
 ```bash
@@ -95,6 +101,23 @@ sudo baudbot env set ANTHROPIC_API_KEY
 
 See [CONFIGURATION.md](CONFIGURATION.md) for required environment variables and secret setup.
 
+## The Slack broker (optional)
+
+The primary way to talk to Baudbot remotely is through Slack.
+
+You have two choices:
+
+1) By creating your own Slack app (more work)
+2) By using our hosted Slack broker + control plane at https://baudbot.ai (easy)
+
+What the Slack broker does:
+- One-click install to connect your Slack workspace to your Baudbot instance
+- Broker forwards messages to your Baudbot instance (encrypted)
+- Broker strips PII and sensitive values
+- Broker tool-restricts access to individual Slack users, channels, etc (COMING SOON)
+
+The broker does not have access to your Baudbot instance. Baudbot is pull-only; it doesn't expose additional ports or host a control plane.
+
 ## Core agents
 
 | Role | Purpose |

From 2ea9c691e76b229fdfb9472477d2efbcf89b91a4 Mon Sep 17 00:00:00 2001
From: Ben Vinegar <2153+benvinegar@users.noreply.github.com>
Date: Mon, 23 Feb 2026 09:27:07 -0500
Subject: [PATCH 2/2] Add comment

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ff441bf..058ebb0 100644
--- a/README.md
+++ b/README.md
@@ -107,8 +107,8 @@ The primary way to talk to Baudbot remotely is through Slack.
 
 You have two choices:
 
-1) By creating your own Slack app (more work)
-2) By using our hosted Slack broker + control plane at https://baudbot.ai (easy)
+1. **Create/manage your own Slack app** (hard)
+2. **Use our hosted Slack broker + control plane** at https://baudbot.ai (easy) [ALPHA]
 
 What the Slack broker does:
 - One-click install to connect your Slack workspace to your Baudbot instance