From db23d08a01f3127b3a30f654976aad65e51de90e Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Tue, 13 Jan 2026 01:19:26 +0000
Subject: [PATCH] Add local Chrome extension setup guide and install script

- Add SETUP_LOCAL.md with step-by-step installation instructions
- Add install-chrome-extension.sh to help users install the extension
- Script verifies extension files and opens Chrome extensions page
---
 SETUP_LOCAL.md              | 57 +++++++++++++++++++++++++++
 install-chrome-extension.sh | 78 +++++++++++++++++++++++++++++++++++++
 2 files changed, 135 insertions(+)
 create mode 100644 SETUP_LOCAL.md
 create mode 100755 install-chrome-extension.sh

diff --git a/SETUP_LOCAL.md b/SETUP_LOCAL.md
new file mode 100644
index 0000000..0b45136
--- /dev/null
+++ b/SETUP_LOCAL.md
@@ -0,0 +1,57 @@
+# Local Chrome Extension Setup Guide
+
+## Quick Setup for Omni Extension
+
+This guide will help you install the Omni extension locally in Chrome.
+
+### Prerequisites
+- Google Chrome browser
+- This repository cloned/downloaded to your local machine
+
+### Installation Steps
+
+#### Step 1: Open Chrome Extensions Page
+Navigate to `chrome://extensions/` in your Chrome browser.
+
+#### Step 2: Enable Developer Mode
+Toggle the "Developer mode" switch in the top-right corner of the extensions page.
+
+#### Step 3: Load the Extension
+Click "Load unpacked" button and select the `src` folder from this repository:
+```
+/workspace/src
+```
+
+#### Step 4: Verify Installation
+You should now see "Omni - Bookmark, History, & Tab Manager" in your extensions list.
+
+### Using Omni
+
+- **Open Omni**: Press `Ctrl+Shift+K` (Windows/Linux) or `Cmd+Shift+K` (Mac)
+- **Close Omni**: Press `Esc` or click outside the interface
+- **Pin Extension**: Click the puzzle icon in Chrome toolbar and pin Omni for quick access
+
+### Available Commands
+- `/tabs` - Search your tabs
+- `/bookmarks` - Search your bookmarks
+- `/history` - Search your browser history
+- `/actions` - Search all available actions
+- `/remove` - Remove a bookmark or close a tab
+
+### Troubleshooting
+
+**Extension not loading?**
+1. Make sure you selected the `src` folder (not the root folder or a ZIP file)
+2. Check the Chrome extensions page for any error messages
+3. Try reloading the extension by clicking the refresh icon
+
+**Keyboard shortcut not working?**
+1. Go to `chrome://extensions/shortcuts`
+2. Find "Omni" and set your preferred shortcut
+
+**Extension not appearing on some pages?**
+Some Chrome system pages (chrome://, chrome-extension://) don't allow extensions to run.
+
+### Development
+
+If you make changes to the extension code, click the refresh button on the extension card in `chrome://extensions/` to reload it.
diff --git a/install-chrome-extension.sh b/install-chrome-extension.sh
new file mode 100755
index 0000000..760e718
--- /dev/null
+++ b/install-chrome-extension.sh
@@ -0,0 +1,78 @@
+#!/bin/bash
+
+# Omni Chrome Extension Local Installer
+# This script helps you install the Omni extension in Chrome
+
+echo "╔════════════════════════════════════════════════════════════════╗"
+echo "║           Omni Chrome Extension - Local Installation           ║"
+echo "╚════════════════════════════════════════════════════════════════╝"
+echo ""
+
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SRC_DIR="$SCRIPT_DIR/src"
+
+echo "📁 Extension source directory: $SRC_DIR"
+echo ""
+
+# Check if src directory exists
+if [ ! -d "$SRC_DIR" ]; then
+    echo "❌ Error: src directory not found at $SRC_DIR"
+    exit 1
+fi
+
+# Check if manifest.json exists
+if [ ! -f "$SRC_DIR/manifest.json" ]; then
+    echo "❌ Error: manifest.json not found in src directory"
+    exit 1
+fi
+
+echo "✅ Extension files verified!"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "📋 INSTALLATION STEPS:"
+echo ""
+echo "1. Open Chrome and navigate to: chrome://extensions/"
+echo ""
+echo "2. Enable 'Developer mode' (toggle in top-right corner)"
+echo ""
+echo "3. Click 'Load unpacked' button"
+echo ""
+echo "4. Select this folder:"
+echo "   $SRC_DIR"
+echo ""
+echo "5. Done! Press Ctrl+Shift+K (or Cmd+Shift+K on Mac) to open Omni"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Try to open Chrome extensions page
+echo "🚀 Attempting to open Chrome extensions page..."
+
+# Detect OS and open Chrome
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    # macOS
+    open -a "Google Chrome" "chrome://extensions/"
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+    # Linux
+    if command -v google-chrome &> /dev/null; then
+        google-chrome "chrome://extensions/" &
+    elif command -v google-chrome-stable &> /dev/null; then
+        google-chrome-stable "chrome://extensions/" &
+    elif command -v chromium-browser &> /dev/null; then
+        chromium-browser "chrome://extensions/" &
+    else
+        echo "⚠️  Could not find Chrome. Please open chrome://extensions/ manually."
+    fi
+elif [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "cygwin" ]] || [[ "$OSTYPE" == "win32" ]]; then
+    # Windows
+    start chrome "chrome://extensions/"
+else
+    echo "⚠️  Unknown OS. Please open chrome://extensions/ manually."
+fi
+
+echo ""
+echo "💡 Tip: After installing, pin the extension for quick access!"
+echo "   Click the puzzle icon 🧩 in Chrome toolbar and pin Omni."
+echo ""