ssh Ref di Libor Benes (Dr. B)

🏛 About ssh Ref:
ssh Ref surfaces a curated, searchable reference of ssh commands and options in one sidebar, color-coded and copy-ready, without leaving the page you're on and without the need to reach for man pages or scattered blog posts.

📐 Desktop Sidebar Design:
🔎 Live Filter: Type to narrow all 61 commands by command text, description, or category.
🗂 Ten Categories: Connecting, authentication, port forwarding, session behavior, ssh-keygen, ssh-agent and ssh-add, ssh-copy-id, scp, sftp, and the client config file, each with its own header.
📋 Click-to-Copy: Click the Copy button next to any command to copy it to the clipboard.
🎨 Neon Terminal Theme: Commands in cyan, categories in fuchsia, on a dark background for high contrast.

⚙ How It Works — Nothing Sent Anywhere:
• ssh Ref's entire 61-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 ssh commands that matter." ssh Ref's built-in reference covers 61 of the ones you'll actually use — connection and authentication flags, port forwarding and tunneling, session behavior, key and agent management, and the full OpenSSH toolset of scp, sftp, ssh-keygen, and ssh-copy-id — grouped into 10 categories.

📊 What You See:
📇 Category Header: Groups commands under connecting, authentication, forwarding, key management, file transfer, or config syntax.
🔧 Command Card: The command's syntax and a plain-language description underneath.
⌨ Copy Row: Every command paired with a one-click copy affordance.
🔎 Empty State: A clear "no matches" message when your filter returns nothing.

🖥 Features:
🎨 Neon Color Coding — Commands in cyan, categories in fuchsia, gold 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.
🗂 Ten Clear Categories — From basic connection syntax through to client config directives.
🪶 Zero Outbound Network Footprint — The extension itself never contacts any server.

🎯 Perfect for:
• Sysadmins and developers who use ssh daily but don't keep every flag memorized.
• Security researchers and pentesters setting up tunnels, jump hosts, or key-based auth mid-engagement.
• Anyone learning the difference between local, remote, and dynamic port forwarding.
• Students exploring how ssh and the broader OpenSSH toolset actually work.

🔒 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: ~17 KB (core scripts: manifest.json + sidebar.html + style.css + script.js + data.js).
• Total Extension Download/Install Size: ~42 KB (including README.md).
Compressed Folder (.zip): ~15 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 — 61 of the most commonly used commands across the ssh toolset are covered; less common flags and configuration options aren't included.
🖥 Desktop Only — Firefox sidebars are not available on Android.
🔧 Assumes Standard Syntax — Commands reflect common defaults; hosts, ports, and paths need adjusting for your own setup.
🧠 Reference Only — Doesn't run any command, open a connection, or touch your system's ssh configuration; it's a lookup tool, not an integration.

⚠ Legal Disclaimer:
ssh 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 OpenSSH, the OpenBSD Project, Mozilla Corporation, Firefox, or any other entity or brand mentioned within it.