Merge pull request #1 from convertivio-design/cursor/chrome-local-setup-61f9

Chrome local setup
This commit is contained in:
convertiv 2026-01-13 01:51:52 -03:00 committed by GitHub
commit 09ea338d42
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 135 additions and 0 deletions

57
SETUP_LOCAL.md Normal file
View file

@ -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.

78
install-chrome-extension.sh Executable file
View file

@ -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 ""