---
name: "Matrix bot help command lists available bot commands"
---

# Story 285: Matrix bot help command lists available bot commands

## User Story

As a user in a Matrix room, I want to type "{bot_name} help" and get a list of all available bot commands with brief descriptions, so that I can discover what the bot can do without having to ask or remember.

## Acceptance Criteria

- [ ] Chat command "{bot_name} help" displays a list of all available bot-level commands (bot name comes from display_name in bot.toml)
- [ ] Each command is shown with a short description of what it does
- [ ] Help output is formatted for readability in Matrix
- [ ] Help command is handled at the bot level — does not require a full Claude invocation
- [ ] Help list automatically includes new commands as they are added (driven by a registry or similar, not a hardcoded string)

## Notes

- **2026-03-18**: Moved back to current from done. Previous attempt committed code directly to master (commit a32cfbd) instead of the worktree, and the help command is not functional in the running server. Needs a clean implementation this time.

## Out of Scope

- TBD
