From 240b491050a56f9aca49cd14bdc75e8a155675af Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Mon, 28 Jul 2025 14:20:54 +0200
Subject: [PATCH] sync descriptions of web settings with mac

---
 web/src/client/components/settings.ts | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/web/src/client/components/settings.ts b/web/src/client/components/settings.ts
index 892697ed..44a27903 100644
--- a/web/src/client/components/settings.ts
+++ b/web/src/client/components/settings.ts
@@ -484,11 +484,12 @@ export class Settings extends LitElement {
                       <div>
                         <h4 class="text-sm font-medium text-muted mb-3">Notification Types</h4>
                         <div class="space-y-2 bg-base rounded-lg p-3">
-                          ${this.renderNotificationToggle('sessionExit', 'Session Exit', 'When a session terminates')}
-                          ${this.renderNotificationToggle('sessionStart', 'Session Start', 'When a new session starts')}
-                          ${this.renderNotificationToggle('commandError', 'Session Errors', 'When errors occur in sessions')}
-                          ${this.renderNotificationToggle('commandCompletion', 'Command Completion', 'When long-running commands finish')}
-                          ${this.renderNotificationToggle('bell', 'System Alerts', 'Important system notifications')}
+                          ${this.renderNotificationToggle('sessionExit', 'Session Exit', 'When a session terminates or crashes (shows exit code)')}
+                          ${this.renderNotificationToggle('sessionStart', 'Session Start', 'When a new session starts (useful for shared terminals)')}
+                          ${this.renderNotificationToggle('commandError', 'Session Errors', 'When commands fail with non-zero exit codes')}
+                          ${this.renderNotificationToggle('commandCompletion', 'Command Completion', 'When commands taking >3 seconds finish (builds, tests, etc.)')}
+                          ${this.renderNotificationToggle('bell', 'System Alerts', 'Terminal bell (^G) from vim, IRC mentions, completion sounds')}
+                          ${this.renderNotificationToggle('claudeTurn', 'Claude Turn', 'When Claude AI finishes responding and awaits input')}
                         </div>
                       </div>
 
@@ -496,8 +497,8 @@ export class Settings extends LitElement {
                       <div>
                         <h4 class="text-sm font-medium text-muted mb-3">Notification Behavior</h4>
                         <div class="space-y-2 bg-base rounded-lg p-3">
-                          ${this.renderNotificationToggle('soundEnabled', 'Sound', 'Play sound with notifications')}
-                          ${this.renderNotificationToggle('vibrationEnabled', 'Vibration', 'Vibrate device with notifications')}
+                          ${this.renderNotificationToggle('soundEnabled', 'Sound', 'Play a notification sound when alerts are triggered')}
+                          ${this.renderNotificationToggle('vibrationEnabled', 'Vibration', 'Vibrate device with notifications (mobile devices only)')}
                         </div>
                       </div>
                     </div>