diff --git a/README.md b/README.md
index 70718ad8..5a6a833c 100644
--- a/README.md
+++ b/README.md
@@ -31,6 +31,27 @@
 
 ## What Claudeman Does
 
+### 🔔 Notification System
+
+Real-time desktop notifications when sessions need attention — never miss a permission prompt or idle session again:
+
+| Hook Event | Urgency | Tab Alert | Meaning |
+|------------|---------|-----------|---------|
+| `permission_prompt` | Critical | Red blink | Claude needs tool approval |
+| `elicitation_dialog` | Critical | Red blink | Claude is asking a question |
+| `idle_prompt` | Warning | Yellow blink | Session idle, waiting for input |
+| `stop` | Info | — | Response complete |
+
+**Features:**
+- Browser notifications enabled by default (auto-requests permission)
+- Click any notification to jump directly to the affected session
+- Tab blinking alerts: red for action-required, yellow for idle
+- Notifications include actual context (tool name, command, question text)
+- Hooks are auto-configured per case directory (`.claude/settings.local.json`)
+- Requires `--https` flag for browser notification API support
+
+---
+
 ### 💾 Persistent Screen Sessions
 
 Every Claude session runs inside **GNU Screen** — sessions survive server restarts, network drops, and machine sleep.
@@ -159,27 +180,6 @@ curl -X POST localhost:3000/api/sessions/:id/auto-compact \
 
 ---
 
-### 🔔 Desktop Notifications via Hooks
-
-Automatic desktop notifications when sessions need attention — powered by Claude Code's hooks system:
-
-| Hook Event | Urgency | Tab Alert | Meaning |
-|------------|---------|-----------|---------|
-| `permission_prompt` | Critical | Red blink | Claude needs tool approval |
-| `elicitation_dialog` | Critical | Red blink | Claude is asking a question |
-| `idle_prompt` | Warning | Yellow blink | Session idle, waiting for input |
-| `stop` | Info | — | Response complete |
-
-**Features:**
-- Browser notifications enabled by default (auto-requests permission)
-- Click any notification to jump directly to the affected session
-- Tab blinking alerts: red for action-required, yellow for idle
-- Notifications include actual context (tool name, command, question text)
-- Hooks are auto-configured per case directory (`.claude/settings.local.json`)
-- Requires `--https` flag for browser notification API support
-
----
-
 ### 🖥️ Multi-Session Dashboard
 
 Run **20 parallel sessions** with full visibility: