tmux Ref di Libor Benes (Dr. B)

🏛 About tmux Ref:
tmux's keybindings are easy to forget between sessions, and reaching for man tmux or a browser tab breaks your flow.

tmux Ref surfaces a curated, searchable reference in one sidebar, color-coded and copy-ready, without leaving the page you're on.

📐 Desktop Sidebar Design:
🔎 Live Filter: Type to narrow all 45 commands by keybinding, command text, description, or category.
🗂 Six Categories: Sessions, windows, panes, copy mode, layout, and misc, each with its own header.
📋 Click-to-Copy: Click any row, or focus it with Tab and press Enter or Space, to copy that command to the clipboard.
🎨 Neon Terminal Theme: Commands in green, categories in cyan, on a near-black background for high contrast.

⚙ How It Works — Nothing Sent Anywhere:
• tmux Ref's entire 45-command reference is bundled as static, hand-authored data; nothing is fetched or looked up externally.
• Filtering and rendering happen entirely client-side.
• Every row and label is built with safe, text-only DOM methods — nothing is ever inserted as HTML.
• The only privileged action is writing a copied command to your clipboard when you click it.

📚 Command Coverage:
There's no single canonical list of "the tmux commands that matter." tmux Ref's built-in reference covers 45 of the ones you'll actually use — session, window, and pane management, copy mode, layout cycling, and a handful of miscellaneous commands — grouped into 6 categories you can filter by name.

📊 What You See:
📇 Category Header: Groups commands under sessions, windows, panes, copy mode, layout, or misc.
⌨ Command Row: The keybinding or command, its description, and a copy affordance.
🔎 Empty State: A clear "no matches" message when your filter returns nothing.

🖥 Features:
🎨 Neon Color Coding — Commands in green, categories in cyan, magenta focus states — always readable, always high-contrast.
🔎 Instant Filtering — Narrows the full list as you type, across commands, descriptions, and categories.
📋 One-Click Copy — Copy any command straight to the clipboard from the keyboard or mouse.
🗂 Six Clear Categories — Sessions, windows, panes, copy mode, layout, misc.
🪶 Zero Outbound Network Footprint — The extension itself never contacts any server.

🎯 Perfect for:
• Developers and sysadmins who use tmux daily but don't have every keybinding memorized.
• Anyone new to tmux who wants a browsable reference instead of scrollback of forgotten man output.
• Programmers and instructors demonstrating tmux to others.
• Students learning terminal multiplexing for the first time.

🔒 Security-First Architecture:
✅ No Data Collection — Explicitly declared in manifest.json.
✅ No Telemetry — No analytics, no tracking, no third-party requests.
✅ No eval() or innerHTML — Safe, text-only DOM methods throughout.
✅ No Persistent Storage — No preferences or data are saved; nothing survives beyond the current sidebar session.
✅ No Network Access — No host permissions requested, no network requests made.
✅ Permissions Matched to Function — clipboardWrite only, for the Copy action — nothing more.

🛠 Technical Details:
• Compatibility: Firefox 140.0+ Desktop only.
• Runtime Execution RAM Footprint: ~12 KB (core scripts: manifest.json + sidebar.html + style.css + script.js + data.js).
• Total Extension Download/Install Size: ~32 KB (including README.md).
Entry point: sidebar_action panel (sidebar.html).
• Compressed Folder (.zip): ~12 KB.
• Network requests: None initiated by the extension.
• Storage: None. No browser.storage API is used.
• Permissions requested: clipboardWrite only.
• Data Collection: None (explicitly declared).

⚠ Limitations:
📚 Curated, Not Exhaustive — 45 of the most commonly used commands and keybindings are covered; less common commands and custom bindings aren't included.
🖥 Desktop Only — Firefox sidebars are not available on Android.
⌨ Assumes Default Bindings — Keybindings reflect tmux's default Ctrl+b prefix; they won't match a remapped config.
🧠 Reference Only — Doesn't run tmux, detect a terminal, or read your config; it's a lookup tool, not an integration.

⚠ Legal Disclaimer:
tmux Ref is an independent browser extension developed for informational and reference purposes. It is not affiliated with, endorsed by, sponsored by, or in any way officially connected to the tmux project, its maintainers, Mozilla Corporation, Firefox, or any other entity or brand mentioned within the extension.