From b62473c46897dcd30d725db8e08d3d698fca8b78 Mon Sep 17 00:00:00 2001
From: nikita <nikita@dowow.su>
Date: Wed, 2 Sep 2026 18:24:24 +0300
Subject: [PATCH] Updated README

---
 README.md | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 08b654b..557e42f 100644
--- a/README.md
+++ b/README.md
@@ -16,24 +16,26 @@ python -m pip install git+https://git.tyukalov.su/nikita/mab
 
 ## Basic usage
 
-This is the most simple bot you can create
+This is the most simple bot you can create. It would respond to any message
+that starts with `!test`, `!hello` or `!hi`.
 
 ```python
 import asyncio
 from mab import MatrixBot, MatrixBotConfig
+from mab import TextCommandFilter
+
 from nio import MatrixRoom, MatrixMessageText
 
 bot: MatrixBot
 
-async def on_room_message_text(room: MatrixRoom, event: RoomMessageText) -> None:
+async def on_valid_command(room: MatrixRoom, event: RoomMessageText) -> None:
     global bot
     # do not respond to ourselves
     if event.sender == bot.get_client().user_id:
         return
-    text = f"You message contains {len(event.body)} symbols"
+    text = f"Your message contains {len(event.body)} symbols"
     await bot.send_text_to_room(room.room_id, text)
 
-
 async def main() -> None:
     global bot
     # create and start the bot
@@ -43,6 +45,10 @@ async def main() -> None:
         storage_directory=Path("storage_nagibator666")
     )
     bot = MatrixBot(matrix_bot_config)
+    bot.add_event_callback(
+        on_valid_command,
+        TextCommandFilter(["test", "hello", "hi"])
+    )
     bot.start()
     # wait for Ctrl+C
     try: