From d9f7a3f7cce86619096b58b1825da852fb4ca89a Mon Sep 17 00:00:00 2001
From: user <user@rpios.local>
Date: Sun, 15 Feb 2026 13:52:21 +0100
Subject: [PATCH] docs: document invite auto-join behavior

---
 docs/CHEATSHEET.md | 2 ++
 docs/USAGE.md      | 5 +++++
 2 files changed, 7 insertions(+)

diff --git a/docs/CHEATSHEET.md b/docs/CHEATSHEET.md
index 97cfb7b..af78259 100644
--- a/docs/CHEATSHEET.md
+++ b/docs/CHEATSHEET.md
@@ -100,6 +100,8 @@ IRC operators are auto-detected via WHO on connect and on user JOIN
 !mode +o nick              # Give ops
 ```
 
+Auto-joins channels when invited by an admin/ircop.
+
 ## State Store (admin)
 
 ```
diff --git a/docs/USAGE.md b/docs/USAGE.md
index 428e48a..b790aea 100644
--- a/docs/USAGE.md
+++ b/docs/USAGE.md
@@ -296,6 +296,11 @@ channel (not DM).
 
 The bot must have channel operator status for these commands to take effect.
 
+### Invite Auto-Join
+
+When an admin or IRC operator sends an `INVITE`, the bot automatically joins
+the target channel. Non-admin invites are silently ignored.
+
 ## Plugin State Persistence
 
 Plugins can persist key-value data across restarts via `bot.state`: