---
name: "Matrix bot ambient mode toggle via chat command"
---

# Story 282: Matrix bot ambient mode toggle via chat command

## User Story

As a user chatting with Timmy in a Matrix room, I want to toggle between "addressed mode" (bot only responds when mentioned by name) and "ambient mode" (bot responds to all messages) via a chat command, so that I don't have to @-mention the bot on every message when I'm the only one around.

## Acceptance Criteria

- [ ] Matrix bot defaults to addressed mode — only forwards messages containing the bot's name to Claude
- [ ] Chat command "{bot_name} ambient on" switches to ambient mode — bot forwards all room messages to Claude (bot name comes from display_name in bot.toml)
- [ ] Chat command "{bot_name} ambient off" switches back to addressed mode
- [ ] Mode is persisted per-room in bot.toml so it survives bot restarts
- [ ] bot.toml.example includes the ambient_mode setting with a comment explaining it
- [ ] Bot confirms the mode switch with a short response in chat
- [ ] When other users join or are active, user can flip back to addressed mode to avoid noise
- [ ] Ambient mode applies per-room (not globally across all rooms)

## Out of Scope

- TBD
