git Ref di Libor Benes (Dr. B)

git Ref brings a clean, searchable, color-coded reference for Git commands directly into your Firefox sidebar.

Instantly look up what a command does and its basic usage example — organized across all major Git workflows (Setup & Config, Snapshotting, Branching, Merging & Rebasing, Remotes, History Inspection, Undoing Changes, Stashing, Tags, Patching, Submodules, and Maintenance) — perfect for learning, quick recall, and daily work without switching tabs or digging through man pages.

Designed for developers, students, and anyone who wants a fast, visual way to recall what a Git command does and how it's typically used.

🏛 About This Reference:
Git has a large set of commands, and it's easy to forget the exact syntax or purpose of a less common one. git Ref curates the most useful Git commands — each with a plain-language explanation of what it does and a basic usage example using placeholders (e.g. git rebase <base_branch>). It is intentionally a quick-reference companion, not an exhaustive manual or a replacement for official Git documentation.

📐 Desktop Sidebar Design:
• Persistent Sidebar: Appears as a persistent, always-available sidebar in Firefox.
• Live Search: Type to instantly filter commands by name, category, or keyword.
• Dual Views: Toggle between an A–Z list and a By Category view, each grouped and color-coded.
• Expand All Toggle: Switch between a compact list and a fully expanded view showing every description and usage example at once.
• Clickable Category Tags: Click any command's category tag to instantly filter the whole list to that category — no need to switch views first.
• Expandable Cards: Click a command to reveal its description and usage example.
• Hover Info: Hover the title for a quick reminder of what this extension is (and isn't).

⚙ How It Works — 100% Client-Side:
The extension runs entirely locally in your browser. No servers, no accounts, and no data collection of any kind. All command data, search filtering, and category logic are handled in memory from the extension package. Nothing is ever sent over the network.

📊 What You See:
• Instant Filtering: Results update as you type, with matching text highlighted.
• Color-Coded Categories: Each of the 13 command categories has its own distinct, clearly visible accent color.
• Usage Examples: A monospaced, easy-to-scan usage example for each command.
• Results Counter: Always know how many commands match your current search or filter.
• High Contrast: Bold text and strong contrast for easy reading at a glance.

🖥 Features:
• Curated Command Reference: Plain-language explanations for the most useful Git commands.
• Basic Usage Examples: A general usage pattern per command — not a full flag/options manual.
• A–Z / By Category Toggle: Browse however suits the moment.
• Expand All Toggle: See every command's details at once, or keep the list compact.
• Clickable Category Filtering: Jump from any command straight to its full category.
• Live Search: Filter by command name, category, or description keyword in real time.
• 100% Client-Side: No telemetry, no tracking, explicitly declared in manifest.json.

🎯 Perfect for:
• Developers who want a fast memory-jog, not a manual.
• Students and newcomers learning what each Git command does.
• DevOps engineers and technical writers who occasionally need a quick syntax reminder.
• Anyone who wants a searchable, visual overview of Git commands without leaving the browser.

🔒 Security-First Architecture:
• No Data Collection: Explicitly declared in manifest.json.
• No Telemetry: Zero network requests or external connections.
• No Risky Code: Safe DOM methods only, no eval() or unsanitized innerHTML.
• No Permissions Required: The extension requests nothing beyond the sidebar panel itself.
• Flat & Auditable Structure: Simple, transparent codebase — six files total.

🛠 Technical Details:
• Compatibility: Firefox 140.0+ Desktop only.
• Runtime Execution RAM Footprint: ~24 KB (core scripts: manifest.json + sidebar.html + sidebar.css + sidebar.js + data.js).
• Total Extension Download/Install Size: ~69 KB (including README.md).
• Entry point: sidebar_action panel (sidebar.html).
• Network requests: None.
• Storage: None required (all state managed in memory).
• Permissions: None.
• Data Collection: None (explicitly declared).

"A searchable, color-coded reference for Git commands — know what a command does and how it's generally used, at a glance."

⚠ Limitations:
• Reference Tool Only: Does not run, install, or interact with Git or any repository in any way.
• Not Exhaustive: Covers a curated set of the most useful commands, not every Git command and flag.
• Usage Examples, Not Full Manuals: Examples use placeholders and omit exhaustive flag lists — refer to official Git documentation for complete usage.
• Desktop Only: Firefox sidebars are not supported on Android.

⚠ Legal Disclaimer:
git Ref is an independent browser extension and is not affiliated with, funded by, or endorsed by Git, the Git project, Software Freedom Conservancy, or any associated project or trademark holder.