From 0d5dffa6656f1d182ee3b24ee5ab4d3d3dae99cf Mon Sep 17 00:00:00 2001
From: FiniteSkills <finiteskills@gmail.com>
Date: Fri, 3 Jul 2026 11:14:02 +0530
Subject: [PATCH] docs: clarify battery and thermal safety

---
 README.md | 27 ++++++++++++++++++++++-----
 1 file changed, 22 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 41ec346..b7c4728 100644
--- a/README.md
+++ b/README.md
@@ -67,6 +67,20 @@ Check the current system state:
 pmset -g | grep SleepDisabled
 ```
 
+## Fast Recovery
+
+If the Mac behaves unexpectedly, feels too warm, or you are unsure whether keep-awake is still active, run:
+
+```sh
+sudo /usr/bin/pmset -a disablesleep 0
+```
+
+That is the same off command used by the app. You can confirm the state with:
+
+```sh
+pmset -g | grep SleepDisabled
+```
+
 ## Undo Everything
 
 Turn clamshell keep-awake off:
@@ -89,11 +103,14 @@ rm -rf "$HOME/Applications/ClamshellKeeper.app"
 
 ## Safety Defaults
 
-- Battery safety is on by default.
-- If the Mac is on battery and reaches 20%, ClamshellKeeper turns keep-awake off.
-- Timers are available for 1h, 2h, 4h, or Until Off.
-- Quitting the app turns keep-awake off.
-- Recovery command if anything looks wrong:
+- Battery Safety is on by default.
+- When keep-awake is active, the app rechecks power state every 30 seconds.
+- If the Mac is running on battery and reaches 20%, ClamshellKeeper turns keep-awake off and shows a notification.
+- Timers are available for 1h, 2h, 4h, or Until Off, so you can avoid leaving keep-awake enabled indefinitely.
+- Quitting the app turns keep-awake off and releases its power assertions.
+- The optional sudoers helper stays limited to the two exact `pmset` commands shown above.
+
+ClamshellKeeper does not monitor temperature, control fans, or replace macOS thermal protection. Keep the Mac ventilated, watch for unusual heat, and turn keep-awake off if the machine feels hotter than expected:
 
 ```sh
 sudo /usr/bin/pmset -a disablesleep 0