diff --git a/docs/weechat.md b/docs/weechat.md
new file mode 100644
index 0000000..9b414de
--- /dev/null
+++ b/docs/weechat.md
@@ -0,0 +1,18 @@
+# Weechat
+
+- Website: https://weechat.org/
+
+## Enable mouse support
+
+```
+/set weechat.look.mouse on
+/mouse enable
+```
+
+## Hide join/part/quit messages
+
+```
+/set irc.look.smart_filter on
+/filter add irc_smart * irc_smart_filter *
+/set irc.look.smart_filter_delay 5
+```
\ No newline at end of file