claude-threads 1.16.3 → 1.17.0

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.17.0] - 2026-06-05
+
+### Added
+- **`!mentions` quiet mode: respond only when @mentioned.** New per-session toggle for holding side conversations inside a bot thread without the bot replying to every message. `!mentions on` makes the bot ignore thread replies that don't explicitly @mention it; `!mentions off` (or a bare `!mentions` to flip the current value) turns it back off. Commands and pending worktree-branch-name prompts always bypass the gate, so `!mentions off` (and answering a worktree prompt) works even while quiet mode is on. When quiet mode is on, the session header shows a row noting it, so a returning user can see why the bot is staying quiet. The setting is owned by the session owner or a globally allowed user and persists across a bot restart. A global `respondOnlyWhenMentioned: true` in `config.yaml` (also offered in the onboarding wizard) seeds quiet mode on every new thread, so users who mostly want quiet threads don't have to run `!mentions on` each time; each session still keeps its own value and can override per-thread. The default everywhere is unchanged (the bot treats every approved-user reply as input), so existing threads and configs are unaffected. (#402)
+
+### Dependencies
+- **Production:** `js-yaml` 4.1.1 → 4.2.0, `react` 19.2.6 → 19.2.7. (#404)
+- **Dev:** `typescript-eslint` 8.60.0 → 8.60.1. (#403)
+
 ## [1.16.3] - 2026-05-31
 
 ### Changed

package/README.md

@@ -85,6 +85,7 @@ Type `!help` in any session thread:
 | `!compact`                                  | Compress context to free up space                                                        |
 | `!cd <path>`                                | Change working directory (restarts Claude)                                               |
 | `!permissions <mode>`                       | Set permission mode: `default` / `auto` / `bypass`                                       |
+| `!mentions [on\|off]`                       | Quiet mode: only respond when @mentioned (bare `!mentions` toggles)                      |
 | `!worktree <branch>`                        | Create and switch to a git worktree (also: `list`, `switch`, `remove`, `cleanup`, `off`) |
 | `!plugin <list\|install\|uninstall> [name]` | Manage Claude Code plugins (restarts Claude)                                             |
 | `!invite @user`                             | Invite a user to this session (added as `Co-Authored-By:` on commits)                    |

package/dist/index.js

@@ -54157,6 +54157,13 @@ async function runOnboarding(reconfigure = false) {
         { title: "Require", value: "require", description: "Always require branch name before starting" }
       ],
       initial: existingConfig?.worktreeMode === "off" ? 1 : existingConfig?.worktreeMode === "require" ? 2 : 0
+    },
+    {
+      type: "confirm",
+      name: "respondOnlyWhenMentioned",
+      message: "Respond only when @mentioned?",
+      initial: existingConfig?.respondOnlyWhenMentioned || false,
+      hint: "New threads start in quiet mode; users can still toggle per-thread with !mentions"
     }
   ], { onCancel });
   const config = {
@@ -54164,6 +54171,9 @@ async function runOnboarding(reconfigure = false) {
     ...globalSettings,
     platforms: []
   };
+  if (!config.respondOnlyWhenMentioned) {
+    delete config.respondOnlyWhenMentioned;
+  }
   console.log("");
   console.log(bold("  Platform Setup"));
   console.log("");
@@ -54274,7 +54284,7 @@ async function runReconfigureFlow(existingConfig) {
       {
         title: "Global settings",
         value: "global",
-        description: `workingDir, chrome, worktreeMode`
+        description: `workingDir, chrome, worktreeMode, mentions`
       }
     ];
     for (let i2 = 0;i2 < config.platforms.length; i2++) {
@@ -54321,9 +54331,19 @@ async function runReconfigureFlow(existingConfig) {
             { title: "Require", value: "require", description: "Always require branch name before starting" }
           ],
           initial: config.worktreeMode === "off" ? 1 : config.worktreeMode === "require" ? 2 : 0
+        },
+        {
+          type: "confirm",
+          name: "respondOnlyWhenMentioned",
+          message: "Respond only when @mentioned?",
+          initial: config.respondOnlyWhenMentioned || false,
+          hint: "New threads start in quiet mode; users can still toggle per-thread with !mentions"
         }
       ], { onCancel });
       config = { ...config, ...globalSettings };
+      if (!config.respondOnlyWhenMentioned) {
+        delete config.respondOnlyWhenMentioned;
+      }
       console.log(green("  ✓ Global settings updated"));
     } else if (action === "add-new") {
       console.log("");
@@ -54452,6 +54472,7 @@ async function showConfigSummary(config) {
   console.log(dim(`    Working Directory: ${config.workingDir}`));
   console.log(dim(`    Chrome Integration: ${config.chrome ? "Enabled" : "Disabled"}`));
   console.log(dim(`    Worktree Mode: ${config.worktreeMode}`));
+  console.log(dim(`    Respond Only When Mentioned: ${config.respondOnlyWhenMentioned ? "Enabled" : "Disabled"}`));
   console.log("");
   console.log(dim(`  Platforms (${config.platforms.length}):`));
   for (const platform of config.platforms) {
@@ -59463,6 +59484,14 @@ var COMMAND_REGISTRY = [
     worksInFirstMessage: true,
     isStackable: true
   },
+  {
+    command: "mentions",
+    description: "Toggle quiet mode: only respond when @mentioned by name",
+    args: "on / off",
+    category: "settings",
+    audience: "user",
+    claudeNotes: "User decisions, not yours"
+  },
   {
     command: "update",
     description: "Show auto-update status",
@@ -59572,6 +59601,7 @@ var COMMAND_PATTERNS = [
   ["invite", /^!invite\s+@?([\w.-]+)\s*$/i],
   ["kick", /^!kick\s+@?([\w.-]+)\s*$/i],
   ["permissions", /^!permissions?\s+(default|auto|bypass|interactive|skip)\s*$/i],
+  ["mentions", /^!mentions(?:\s+(on|off))?\s*$/i],
   ["update", /^!update(?:\s+(now|defer))?\s*$/i],
   ["context", /^!context\s*$/i],
   ["cost", /^!cost\s*$/i],
@@ -59956,6 +59986,15 @@ var handlePermissions = async (ctx, args) => {
   await ctx.sessionManager.setSessionPermissionMode(ctx.threadId, ctx.username, mode);
   return { handled: true };
 };
+var handleMentions = async (ctx, args) => {
+  if (ctx.commandContext === "first-message") {
+    return { handled: false };
+  }
+  if (ctx.isAllowed) {
+    await ctx.sessionManager.setRespondOnlyWhenMentioned(ctx.threadId, ctx.username, args);
+  }
+  return { handled: true };
+};
 var handleWorktree = async (ctx, args) => {
   const parts = args?.split(/\s+/) || [];
   const subcommandOrBranch = parts[0]?.toLowerCase();
@@ -60089,6 +60128,7 @@ handlers.set("kick", handleKick);
 handlers.set("github-email", handleGitHubEmail);
 handlers.set("cd", handleCd);
 handlers.set("permissions", handlePermissions);
+handlers.set("mentions", handleMentions);
 handlers.set("worktree", handleWorktree);
 handlers.set("bug", handleBug);
 handlers.set("plugin", handlePlugin);
@@ -71262,6 +71302,31 @@ async function kickUser(session, kickedUser, kickedBy, ctx) {
     sessionLog5(session).warn(`\uD83D\uDEAB @${kickedUser} was not in session`);
   }
 }
+async function setRespondOnlyWhenMentioned(session, username, arg, ctx) {
+  if (!await requireSessionOwner(session, username, "change session settings")) {
+    return;
+  }
+  const normalized = arg?.toLowerCase();
+  let enabled;
+  if (normalized === "on") {
+    enabled = true;
+  } else if (normalized === "off") {
+    enabled = false;
+  } else {
+    enabled = !session.respondOnlyWhenMentioned;
+  }
+  session.respondOnlyWhenMentioned = enabled;
+  ctx.ops.persistSession(session);
+  const botName = session.platform.getBotName();
+  if (enabled) {
+    await post(session, "success", `Quiet mode on — I'll only respond when you @mention me (\`@${botName}\`). Use \`!mentions off\` to turn this off.`);
+  } else {
+    await post(session, "success", `Quiet mode off — I'll respond to every message in this thread again.`);
+  }
+  sessionLog5(session).info(`\uD83D\uDD15 respondOnlyWhenMentioned=${enabled} by @${username}`);
+  session.threadLogger?.logCommand("mentions", enabled ? "on" : "off", username);
+  await updateSessionHeader(session, ctx);
+}
 async function setGitHubEmail(session, username, arg, ctx) {
   const formatter = session.platform.getFormatter();
   const trimmed = arg?.trim();
@@ -71436,6 +71501,9 @@ async function updateSessionHeader(session, ctx) {
   if (otherParticipants) {
     items.push(["\uD83D\uDC65", "Participants", otherParticipants]);
   }
+  if (session.respondOnlyWhenMentioned) {
+    items.push(["\uD83D\uDD15", "Replies", `only when ${formatter.formatBold("@mentioned")} (${formatter.formatCode("!mentions off")} to disable)`]);
+  }
   if (session.claudeAccountId) {
     const account = ctx.ops.getClaudeAccount(session.claudeAccountId);
     const label = account?.displayName ?? session.claudeAccountId;
@@ -72090,6 +72158,7 @@ async function startSession(options, username, displayName, replyToPostId, platf
     planApproved: false,
     sessionAllowedUsers: new Set([username]),
     forceInteractivePermissions,
+    respondOnlyWhenMentioned: ctx.config.respondOnlyWhenMentioned ?? false,
     permissionModeOverride: sessionPermissionModeOverride,
     sessionStartPostId: startPost ? startPost.id : null,
     sessionHeaderMode,
@@ -72245,6 +72314,7 @@ Please start a new session.`), { action: "Post resume failure notification" });
     planApproved: state.planApproved ?? false,
     sessionAllowedUsers: new Set(state.sessionAllowedUsers),
     forceInteractivePermissions: state.forceInteractivePermissions ?? false,
+    respondOnlyWhenMentioned: state.respondOnlyWhenMentioned ?? false,
     sessionStartPostId: state.sessionStartPostId ?? null,
     sessionHeaderMode: resumeSessionHeaderMode(state.sessionHeaderMode, ctx.ops.getPlatformOverhead(platformId).sessionHeader),
     timers: createSessionTimers(),
@@ -72982,6 +73052,7 @@ class SessionManager extends EventEmitter4 {
   permissionMode;
   chromeEnabled;
   worktreeMode;
+  respondOnlyWhenMentioned;
   threadLogsEnabled;
   threadLogsRetentionDays;
   limits;
@@ -73000,12 +73071,13 @@ class SessionManager extends EventEmitter4 {
   platformOverhead = new Map;
   autoUpdateManager = null;
   accountPool;
-  constructor(workingDir, permissionModeOrSkipFlag = "default", chromeEnabled = false, worktreeMode = "prompt", sessionsPath, threadLogsEnabled = true, threadLogsRetentionDays = 30, limits, claudeAccounts) {
+  constructor(workingDir, permissionModeOrSkipFlag = "default", chromeEnabled = false, worktreeMode = "prompt", sessionsPath, threadLogsEnabled = true, threadLogsRetentionDays = 30, limits, claudeAccounts, respondOnlyWhenMentioned = false) {
     super();
     this.workingDir = workingDir;
     this.permissionMode = typeof permissionModeOrSkipFlag === "boolean" ? permissionModeOrSkipFlag ? "bypass" : "default" : permissionModeOrSkipFlag;
     this.chromeEnabled = chromeEnabled;
     this.worktreeMode = worktreeMode;
+    this.respondOnlyWhenMentioned = respondOnlyWhenMentioned;
     this.threadLogsEnabled = threadLogsEnabled;
     this.threadLogsRetentionDays = threadLogsRetentionDays;
     this.limits = resolveLimits(limits);
@@ -73093,6 +73165,7 @@ class SessionManager extends EventEmitter4 {
       workingDir: this.workingDir,
       permissionMode: this.permissionMode,
       chromeEnabled: this.chromeEnabled,
+      respondOnlyWhenMentioned: this.respondOnlyWhenMentioned,
       debug: this.debug,
       maxSessions: this.limits.maxSessions,
       threadLogsEnabled: this.threadLogsEnabled,
@@ -73286,6 +73359,7 @@ class SessionManager extends EventEmitter4 {
       planApproved: session.planApproved,
       sessionAllowedUsers: [...session.sessionAllowedUsers],
       forceInteractivePermissions: session.forceInteractivePermissions,
+      respondOnlyWhenMentioned: session.respondOnlyWhenMentioned,
       sessionStartPostId: session.sessionStartPostId,
       tasksPostId: taskListSnapshot?.postId ?? null,
       lastTasksContent: taskListSnapshot?.content ?? null,
@@ -73583,6 +73657,12 @@ class SessionManager extends EventEmitter4 {
       return;
     await setGitHubEmail(session, username, arg, this.getContext());
   }
+  async setRespondOnlyWhenMentioned(threadId, username, arg) {
+    const session = this.findSessionByThreadId(threadId);
+    if (!session)
+      return;
+    await setRespondOnlyWhenMentioned(session, username, arg, this.getContext());
+  }
   async setSessionPermissionMode(threadId, username, mode) {
     const session = this.findSessionByThreadId(threadId);
     if (!session)
@@ -83543,6 +83623,9 @@ async function handleMessage(client, session, post2, user, options) {
             return;
         }
       }
+      if (activeSession.respondOnlyWhenMentioned && !client.isBotMentioned(message)) {
+        return;
+      }
       if (!session.isUserAllowedInSession(threadRoot, username)) {
         if (content)
           await session.requestMessageApproval(threadRoot, username, content);
@@ -84878,7 +84961,7 @@ async function startWithoutDaemon() {
   keepAlive.setEnabled(keepAliveEnabled);
   const threadLogsEnabled = config.threadLogs?.enabled ?? true;
   const threadLogsRetentionDays = config.threadLogs?.retentionDays ?? 30;
-  const session = new SessionManager(workingDir, initialPermissionMode, config.chrome, config.worktreeMode, undefined, threadLogsEnabled, threadLogsRetentionDays, config.limits, config.claudeAccounts);
+  const session = new SessionManager(workingDir, initialPermissionMode, config.chrome, config.worktreeMode, undefined, threadLogsEnabled, threadLogsRetentionDays, config.limits, config.claudeAccounts, config.respondOnlyWhenMentioned);
   if (config.stickyMessage) {
     session.setStickyMessageCustomization(config.stickyMessage.description, config.stickyMessage.footer);
   }

package/dist/mcp/mcp-server.js

@@ -55520,6 +55520,14 @@ var COMMAND_REGISTRY = [
     worksInFirstMessage: true,
     isStackable: true
   },
+  {
+    command: "mentions",
+    description: "Toggle quiet mode: only respond when @mentioned by name",
+    args: "on / off",
+    category: "settings",
+    audience: "user",
+    claudeNotes: "User decisions, not yours"
+  },
   {
     command: "update",
     description: "Show auto-update status",
@@ -55790,6 +55798,15 @@ var handlePermissions = async (ctx, args) => {
   await ctx.sessionManager.setSessionPermissionMode(ctx.threadId, ctx.username, mode);
   return { handled: true };
 };
+var handleMentions = async (ctx, args) => {
+  if (ctx.commandContext === "first-message") {
+    return { handled: false };
+  }
+  if (ctx.isAllowed) {
+    await ctx.sessionManager.setRespondOnlyWhenMentioned(ctx.threadId, ctx.username, args);
+  }
+  return { handled: true };
+};
 var handleWorktree = async (ctx, args) => {
   const parts = args?.split(/\s+/) || [];
   const subcommandOrBranch = parts[0]?.toLowerCase();
@@ -55923,6 +55940,7 @@ handlers.set("kick", handleKick);
 handlers.set("github-email", handleGitHubEmail);
 handlers.set("cd", handleCd);
 handlers.set("permissions", handlePermissions);
+handlers.set("mentions", handleMentions);
 handlers.set("worktree", handleWorktree);
 handlers.set("bug", handleBug);
 handlers.set("plugin", handlePlugin);

package/docs/CONFIGURATION.md

@@ -9,6 +9,7 @@ version: 1
 workingDir: /home/user/repos/myproject
 chrome: false
 worktreeMode: prompt
+respondOnlyWhenMentioned: false
 
 platforms:
   # Mattermost
@@ -41,6 +42,7 @@ platforms:
 | `workingDir` | Default working directory for Claude | Current directory |
 | `chrome` | Enable Chrome integration | `false` |
 | `worktreeMode` | Git worktree mode: `off`, `prompt`, or `require` | `prompt` |
+| `respondOnlyWhenMentioned` | Start new threads in quiet mode, where the bot only replies to messages that @mention it. Users can still toggle per-thread with `!mentions`. | `false` |
 
 ## Platform Settings
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-threads",
-  "version": "1.16.3",
+  "version": "1.17.0",
   "description": "Share Claude Code sessions live in a Mattermost channel with interactive features",
   "main": "dist/index.js",
   "type": "module",