From 7f290a73c42dbb0be78e8bcb2a1678c86bebadd8 Mon Sep 17 00:00:00 2001
From: Amolith <amolith@secluded.site>
Date: Fri, 31 Oct 2025 16:48:47 -0600
Subject: [PATCH] docs(notification): add 'em

---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/README.md b/README.md
index c040a2ce9bfd160588b0497ba28a3a4c1232c3a8..29590cd7cdac485d8ca7727659e819c08df49c1e 100644
--- a/README.md
+++ b/README.md
@@ -577,6 +577,29 @@ config:
 }
 ```
 
+## Desktop Notifications
+
+Crush defaults to sending desktop notifications that let you know:
+
+- When its turn is finished (automatically cancelled when you send a new
+  message)
+- When it's waiting for permission to execute a tool (automatically cancelled
+  when you interact with the permission dialog)
+
+### Disabling notifications
+
+If you prefer to work without desktop notifications, you can disable them in
+your `crush.json` config.
+
+```json
+{
+  "$schema": "https://charm.land/crush.json",
+  "options": {
+    "disable_notifications": true
+  }
+}
+```
+
 ## Provider Auto-Updates
 
 By default, Crush automatically checks for the latest and greatest list of