From 4b2ac258ee8370d7bf2cc5ece413ae0b81d9a69f Mon Sep 17 00:00:00 2001
From: Retoor <retoor@molodetz.nl>
Date: Wed, 16 Sep 2026 07:03:38 +0000
Subject: [PATCH] docs: Add documentation for --install-shortcut and keyboard
 toggle features

Updated README.md and autocode.md to include:
- Installation and usage of --install-shortcut command
- Toggle automation with Ctrl+A+A keyboard shortcut
- New feature highlights in Features section
- Usage examples for keyboard shortcut setup

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
---
 README.md   | 16 ++++++++++++++++
 autocode.md | 15 +++++++++++++++
 2 files changed, 31 insertions(+)

diff --git a/README.md b/README.md
index 9f675b5..1c20934 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,12 @@ pip install -e .
 
 ### Basic Usage
 
+Install keyboard shortcut (one-time setup):
+```bash
+autoclaude --install-shortcut
+```
+This configures `Ctrl+A+A` to toggle automation for the current pane.
+
 List Claude Code sessions:
 ```bash
 autoclaude list
@@ -23,6 +29,12 @@ Start autonomous monitoring:
 autoclaude start main 8
 ```
 
+Toggle automation for active pane:
+```bash
+autoclaude start toggle
+# Or use keyboard shortcut: Ctrl+A+A
+```
+
 Check status:
 ```bash
 autoclaude status
@@ -41,6 +53,10 @@ autoclaude logs
 - Real-time session monitoring
 - Command-line interface for complete control
 - Configuration-driven behavior
+- Keyboard shortcut for quick automation toggle (Ctrl+A+A)
+- One-command setup with `--install-shortcut`
+- Session and window identification in prompt
+- Visual status display in tmux status bar
 
 ## System Requirements
 
diff --git a/autocode.md b/autocode.md
index d0940e8..78f5370 100644
--- a/autocode.md
+++ b/autocode.md
@@ -101,11 +101,15 @@ Session Commands:
 Service Commands:
 - autoclaude start - Start orchestrator (auto-detect mode)
 - autoclaude start <session> <window> - Start monitoring specific session
+- autoclaude start toggle - Toggle automation for active pane
 - autoclaude stop - Stop all monitoring
 - autoclaude stop <session> <window> - Stop monitoring specific session
 - autoclaude status - Check orchestrator status
 - autoclaude logs - Follow orchestrator logs
 
+Setup Commands:
+- autoclaude --install-shortcut - Install Ctrl+A+A keyboard shortcut in tmux config
+
 ### Usage Examples
 
 Detect all Claude Code sessions:
@@ -133,6 +137,17 @@ Check orchestrator status:
 autoclaude status
 ```
 
+Install keyboard shortcut:
+```bash
+autoclaude --install-shortcut
+```
+
+Toggle automation for active pane:
+```bash
+autoclaude start toggle
+# Or use keyboard shortcut in tmux: Ctrl+A+A
+```
+
 View live logs:
 ```bash
 autoclaude logs