relaybot 1.0.4 → 1.0.6

package/README.md

@@ -1,6 +1,6 @@
 # RelayBot
 
-An AI assistant that lives in your Slack DMs — powered by Claude or Codex.
+An AI assistant that lives in your Slack channels and DMs — powered by Claude or Codex.
 
 <img src="demo/demo.jpg" width="30%">
 
@@ -8,11 +8,11 @@ An AI assistant that lives in your Slack DMs — powered by Claude or Codex.
 
 ## What is RelayBot?
 
-RelayBot acts as a bridge between Slack and AI coding agents, allowing you to interact with Claude or Codex through simple Slack DMs. Instead of switching between tools, you can request code changes, ask questions, and manage development tasks without leaving Slack.
+RelayBot acts as a bridge between Slack and AI coding agents, allowing you to interact with Claude or Codex by mentioning the bot in channels or sending a DM. Instead of switching between tools, you can request code changes, ask questions, and manage development tasks without leaving Slack.
 
 ### Key Features
 
-- **Conversational AI Access** — Chat with Claude or Codex directly from Slack DMs
+- **Conversational AI Access** — Chat with Claude or Codex from Slack channels via mentions or via DM
 - **Code Execution** — AI can read, write, and modify code in your projects
 - **Task Automation** — Request file changes, refactoring, bug fixes, or new features
 - **Context-Aware Responses** — Maintains project directory context across conversations
@@ -37,7 +37,7 @@ RelayBot acts as a bridge between Slack and AI coding agents, allowing you to in
 │                           SLACK                                     │
 │  ┌──────────┐                                    ┌──────────────┐   │
 │  │   User   │ ───── sends message ─────────────► │   Channel/   │   │
-│  │          │ ◄──── receives reply ───────────── │      DM      │   │
+│  │          │ ◄──── receives reply ───────────── │   Channel   │   │
 │  └──────────┘                                    └──────────────┘   │
 └─────────────────────────────────────────────────────────────────────┘
                               │ ▲
@@ -84,12 +84,12 @@ RelayBot acts as a bridge between Slack and AI coding agents, allowing you to in
 
 ## How It Works
 
-1. **Slack Connection** — RelayBot connects to Slack via WebSocket (Socket Mode) and listens for DMs
+1. **Slack Connection** — RelayBot connects to Slack via WebSocket (Socket Mode) and listens for mentions and DMs
 2. **Message Reception** — When you send a message, Slack forwards it to RelayBot
 3. **AI Bridge** — RelayBot spawns a persistent Claude or Codex CLI session and forwards your message
 4. **AI Processing** — The AI processes your request with full access to your codebase
 5. **Response Summarization** — Long outputs are summarized into concise, actionable messages
-6. **Slack Reply** — The summarized response is sent back to you via Slack DM
+6. **Slack Reply** — The summarized response is sent back to the same channel or DM
 
 ---
 
@@ -215,6 +215,7 @@ Socket Mode allows the bot to receive events via WebSocket instead of HTTP endpo
 2. Scroll to **Scopes** → **Bot Token Scopes**
 3. Add these scopes:
    - `chat:write` — Send messages
+   - `app_mentions:read` — Read mentions of your app
    - `im:history` — Read DM history
    - `im:read` — View DM metadata
    - `im:write` — Start DMs with users
@@ -226,6 +227,7 @@ Socket Mode allows the bot to receive events via WebSocket instead of HTTP endpo
 2. Toggle **Enable Events** to ON
 3. Expand **Subscribe to bot events**
 4. Add these events:
+   - `app_mention` — Receive mentions in channels
    - `message.im` — Receive DM messages
 
 #### 5. Install the App

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "display_information": {
     "name": "RelayBot",
-    "description": "An AI assistant that lives in your Slack DMs — powered by Claude or Codex",
+    "description": "An AI assistant that lives in your Slack channels and DMs — powered by Claude or Codex",
     "background_color": "#4A154B"
   },
   "features": {
@@ -14,6 +14,7 @@
     "scopes": {
       "bot": [
         "chat:write",
+        "app_mentions:read",
         "im:history",
         "im:read",
         "im:write",
@@ -24,6 +25,7 @@
   "settings": {
     "event_subscriptions": {
       "bot_events": [
+        "app_mention",
         "message.im"
       ]
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relaybot",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "An AI assistant that lives in your Slack DMs — powered by Claude or Codex",
   "main": "main.js",
   "bin": {

package/src/slack-handlers.js

@@ -24,13 +24,18 @@ function storeLastMessage(message) {
 
 function getPromptSuffix() {
   if (isProduction) {
-    return `\nIMPORTANT: Use the relay-bot skill if it exists. Otherwise, read and follow the instructions in ${skillPath}`;
+    return `\nIMPORTANT: Read and follow the instructions in ${skillPath}`;
   }
   return '\nIMPORTANT: Use the relay-bot skill.';
 }
 
+function stripMentions(text) {
+  if (!text) return text;
+  return text.replace(/<@[^>]+>/g, '').replace(/\s+/g, ' ').trim();
+}
+
 function registerHandlers(app) {
-  app.message(async ({ message, say }) => {
+  async function handleMessage({ message, say, text }) {
     // Only respond to messages from the configured user
     if (config.SLACK_USER_ID && message.user !== config.SLACK_USER_ID) {
       return;
@@ -39,11 +44,28 @@ function registerHandlers(app) {
     storeLastMessage(message);
 
     if (agent.isRunning()) {
-      const fullPrompt = message.text + getPromptSuffix();
+      const fullPrompt = text + getPromptSuffix();
       agent.sendCommand(fullPrompt);
     } else {
       await say('Agent process is not running.');
     }
+  }
+
+  app.event('app_mention', async ({ event, say }) => {
+    if (event.channel_type === 'im' || event.channel_type === 'mpim') {
+      return;
+    }
+
+    const cleanedText = stripMentions(event.text);
+    await handleMessage({ message: event, say, text: cleanedText });
+  });
+
+  app.message(async ({ message, say }) => {
+    if (message.channel_type !== 'im') {
+      return;
+    }
+
+    await handleMessage({ message, say, text: message.text });
   });
 }