matrix-org / matrix-org/matrix-spec

spec idea: bot comands listing

Open
#2,170 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

improvement
Dominant language
HTML
Stars
330
Forks
150
Avg merge
2h 21m
Merged PRs (30d)
3

Description

**Suggestion**

Today (most of the) bots use ! to read commands from messages. It would be easier for people to do / (or even keep !) and get a list of available commands for the bots inside their clients.

Bots would have to register the commands to the client and server in some way.

The other problem this could solve is related to https://github.com/matrix-org/matrix-spec/issues/1109 : messages that are targeted for bots are always public. If commands are registered only the targeted bot could get them (if not a passive command) But at least it could give the user the choice to not let it's bot read everything.

A real spec around bots would help a lot. I couldn't find any spec proposal including this suggestion.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the proposal and the linked Matrix issue #1109. No file, test, or implementation entry point is named, so first determine where bot behavior and command interactions are specified. Done would require a decided scope and an accepted specification for command registration, listing, and message visibility.

Written by the indexing model from the issue text.

Assessment

Domain
backend-api-design, documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.