# NousResearch/hermes-agent · Mattermost gateway @-mention filter feature requests

## Open now

- Nothing open on GitHub.

Multiple related proposals for adding a configurable mode to the Mattermost gateway adapter that restricts bot responses to messages containing @-mentions. The members appear to be duplicate or closely related feature requests for the same functionality.

## TL;DR

- 3 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 1 merged PR(s), 1 PR(s) closed without merging.
- A fix was merged to main in PR #2443. Verify it addresses your case.
- **Recommended:** read PR #2443 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `resolved` · deciding PR(s): `pr-2443`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.67`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #2174: Feature: @-mention-only mode for Mattermost gateway adapter

## Prior & competing PRs

- **#2443: feat(gateway): add @-mention-only filter for Mattermost channels**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`
  - files: `gateway/platforms/mattermost.py`
  - fix hunks:
  - `gateway/platforms/mattermost.py`

    ```diff
    @@ -580,6 +580,24 @@ async def _handle_ws_event(self, event: Dict[str, Any]) -> None:
             # For DMs, user_id is sufficient.  For channels, check for @mention.
             message_text = post.get("message", "")
     
    +        # Mention-only mode: skip channel messages that don't @mention the bot.
    +        # DMs (type "D") are always processed.
    +        if channel_type_raw != "D":
    +            mention_patterns = [
    +                f"@{self._bot_username}",
    +                f"@{self._bot_user_id}",
    +            ]
    +            has_mention = any(
    +                pattern.lower() in message_text.lower()
    +                for pattern in mention_patterns
    +            )
    +            if not has_mention:
    +                logger.debug(
    +                    "Mattermost: skipping non-DM message without @mention (channel=%s)",
    +                    channel_id,
    +                )
    +                return
    +
             # Resolve sender info.
             sender_id = post.get("user_id", "")
             sender_name = data.get("sender_name", "").lstrip("@") or sender_id
    ```
- **#2279: feat(gateway): add @-mention-only filter for Mattermost channels**. closed without merge
  - maintainer direction: category `merged_via`; implication `superseded`; refs `#2443`

## Fix status

- Merged to main in PR #2443 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-03-22`. This confirmation is old and may be out of date (a revert/reopen would not have invalidated it here); re-verify.
- Subsystem: `gateway`