From 420da759a7e726757bd8ab0e97599e7f0354a487 Mon Sep 17 00:00:00 2001
From: David Beesley <37917398+davidbeesley@users.noreply.github.com>
Date: Thu, 22 Jan 2026 20:36:41 -0700
Subject: [PATCH] Readme update: ctrl shift 6 on Mac

---
 README.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 6c68390..11cd510 100644
--- a/README.md
+++ b/README.md
@@ -89,6 +89,8 @@ claude-chill -H 50000 -a 0 -- claude --verbose
 
 Press `Ctrl+6` (or your configured key) to enter lookback mode:
 
+> **macOS Note:** Some Mac terminals don't send control characters for `Ctrl+number` keys.`Ctrl+Shift+6` (i.e., `Ctrl+^`) will work by default, or the lookback key can be customized.
+
 1. **Claude pauses** - Output from Claude is cached, input is blocked
 2. **History dumps** - The full history buffer is written to your terminal
 3. **Scroll freely** - Use your terminal's scrollback to review everything
@@ -135,7 +137,9 @@ Keys: `[a]`-`[z]`, `[f1]`-`[f12]`, `[pageup]`, `[pagedown]`, `[home]`, `[end]`,
 
 ### Why Ctrl+6?
 
-`Ctrl+6` sends 0x1E, a control character not frequently used by terminals, signals, or shells. Avoid `Ctrl+letter` hotkeys - terminals can't distinguish `Ctrl+J` from `Ctrl+Shift+J`.
+`Ctrl+6` sends 0x1E (ASCII RS), a control character not frequently used by terminals, signals, or shells. Avoid `Ctrl+letter` hotkeys - terminals can't distinguish `Ctrl+J` from `Ctrl+Shift+J`.
+
+**macOS caveat:** Mac terminals don't send control characters for `Ctrl+number` combinations. On macOS, press `Ctrl+Shift+6` (equivalent to `Ctrl+^`) which produces the same 0x1E byte. A more portable default key may be chosen in a future release.
 
 ## How It Works