From 6dd73a4326bcc018d39fcf46d4cb1e4584892bf2 Mon Sep 17 00:00:00 2001
From: DannyDannyDanny <dth@taiga.ai>
Date: Fri, 30 Jan 2026 18:22:21 +0100
Subject: [PATCH] Add README to firefox-tabs script

---
 scripts/firefox-tabs/README.md | 55 ++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 scripts/firefox-tabs/README.md

diff --git a/scripts/firefox-tabs/README.md b/scripts/firefox-tabs/README.md
new file mode 100644
index 0000000..11948db
--- /dev/null
+++ b/scripts/firefox-tabs/README.md
@@ -0,0 +1,55 @@
+# Firefox Tabs Script
+
+Get information about Firefox's open tabs from the command line.
+
+## Usage
+
+```bash
+python3 firefox-tabs.py [method] [rdp_port]
+```
+
+**Methods:**
+- `session`, `s` - Read from Firefox session files (default)
+- `rdp`, `r` - Use Remote Debugging Protocol
+- `both`, `b` - Try both methods
+
+**Examples:**
+```bash
+python3 firefox-tabs.py                    # Use session files (default)
+python3 firefox-tabs.py rdp               # Use RDP on default port 6000
+python3 firefox-tabs.py rdp 9222          # Use RDP on port 9222
+```
+
+## Setup
+
+### Using Nix (Recommended)
+
+```bash
+cd scripts/firefox-tabs
+nix develop
+python3 firefox-tabs.py
+```
+
+### Manual Setup
+
+Install Python lz4 library:
+```bash
+pip install lz4
+```
+
+## Remote Debugging Protocol
+
+To use RDP method, enable remote debugging in Firefox:
+
+1. Open Firefox and go to `about:config`
+2. Set these preferences:
+   - `devtools.debugger.remote-enabled` = `true`
+   - `devtools.debugger.remote-port` = `6000`
+3. Restart Firefox
+
+## Requirements
+
+- Python 3
+- `lz4` Python library (for session file method)
+- Firefox installed and run at least once
+