A Chrome extension that makes your browsing history truly searchable and queryable using AI, while keeping everything private and running locally on your device.
This Chrome extension captures and indexes your browser history locally, then lets you search through it using smart AI-powered techniques. You can either search directly or have conversations about your browsing history using Chrome's built-in AI.
- Smart search through your history using hybrid retrieval (combines keyword search + semantic similarity)
- Chat interface where you can ask questions about your browsing history and get AI-powered answers with links
- Multiple search modes: Hybrid+Rerank (default), Hybrid (RRF), Text-only, Vector-only
- Side panel UI with two modes:
- Search page (default) - search your history with different modes
- Chat page - conversational interface powered by Chrome's Prompt API
- Debug page for database management and troubleshooting
- Local‑first - no browsing data leaves your device. Optional model downloads can be enabled.
The extension uses modern AI techniques to understand the meaning and context of web pages you visit:
- Captures your browser history automatically as you browse
- Indexes page content using both traditional keyword search and AI embeddings for semantic understanding
- Stores everything locally using PGlite (PostgreSQL in WASM) with pgvector for vector similarity search
- Searches using hybrid retrieval that combines the best of keyword matching and AI similarity
- Answers questions about your history using Chrome's on-device AI (Chrome Canary required)
Everything runs locally by default. No browsing data is ever transmitted. If you opt in to use a larger embedding model, the extension may download static model files from trusted hosts (see Network Use below). All processing of your browsing history remains on device.
- Chrome Canary 143.0.7448.0 or later
- Chrome AI flags enabled (see HOWTO_CANARY.md for detailed setup)
Download the latest release from the Releases page:
- Download
history-copilot-v*.zipfrom the latest release - Extract the zip file to a location on your computer
Follow the complete setup guide in HOWTO_CANARY.md, or quick setup:
- Open Chrome Canary and navigate to
chrome://flags - Enable the following flags:
chrome://flags/#optimization-guide-on-device-model→ Enabledchrome://flags/#prompt-api-for-gemini-nano→ Enabledchrome://flags/#summarization-api-for-gemini-nano→ Enabled
- Restart Chrome Canary
- Open
chrome://extensionsin Chrome Canary - Enable "Developer mode" using the toggle in the top-right corner
- Click "Load unpacked"
- Select the extracted
chrome-extensionfolder from Step 1 - The extension icon should appear in your toolbar
The extension needs site access to extract page content:
- Click the extension icon and go to the Debug page
- Use "Grant All Sites Access" or grant access per-site as needed
- Alternatively, right-click the extension icon → "This can read and change site data" → "On all sites"
Click the extension icon to open the side panel and start searching your history. Your browsing history becomes a searchable, queryable knowledge base that you can interact with naturally.
To create a new release:
git tag v1.0.0
git push origin v1.0.0GitHub Actions will automatically create a release with the zipped extension.
The extension uses Chrome's on‑device AI APIs (Prompt/Language Model and Summarizer), which are experimental and available in Chrome Canary behind feature flags. Without Canary, chat and summarization features won't be available. Follow the setup guide in HOWTO_CANARY.md.
This extension is local‑first. If you enable the “Use larger remote model (warm in background)” option, the extension may fetch and cache model artifacts from:
- https://huggingface.co
- https://*.huggingface.co
- https://hf.co
- https://*.hf.co
- https://cdn.jsdelivr.net
Notes:
- Only static model files are downloaded. No browsing history, prompts, or user data are uploaded.
- Files are cached in the browser for offline use after the first warm‑up.
- Favicon thumbnails are loaded from Google’s favicon service (
https://www.google.com/s2/favicons) using only the site hostname. - UI fonts: the side panel references Google Fonts in CSS. You can remove that import for a stricter local‑only UI; it is not required for functionality.
MIT License - see LICENSE for details
Simon Cornelius P. Umacob [email protected]