mirror of https://github.com/hanzoai/browser-extension.git synced 2026-10-30 20:02:07 +00:00

Files

T

zeekay 7d62ad6af3 chore: deprecate in favor of hanzoai/extension monorepo

All browser extension code now lives in hanzoai/extension under
packages/browser/. Auth fixes from this repo have been back-merged.

2026-03-05 10:35:14 -08:00

4.7 KiB

Raw Permalink Blame History

DEPRECATED — Moved to hanzoai/extension

This repo is archived. All browser extension development now lives in hanzoai/extension under packages/browser/.

All auth fixes from this repo have been back-merged into the monorepo. Please file issues and PRs there.

Hanzo AI Browser Extension

AI-powered browser extension for Chrome, Firefox, Edge, and Safari.

Features

AI Chat Sidebar: Chat with Claude, GPT-4, Gemini, and more
Page Analysis: Summarize, explain, and query any webpage
Selection Actions: Right-click menu for AI operations on selected text
MCP Integration: Access 260+ MCP tools from your browser
Cloud Sync: Sync conversations and settings via cloud.hanzo.ai

Installation

Chrome / Edge / Brave

Download the latest release from Releases
Open chrome://extensions (or edge://extensions)
Enable "Developer mode"
Click "Load unpacked" and select the dist folder

Firefox

Download the latest release
Open about:debugging
Click "This Firefox" → "Load Temporary Add-on"
Select manifest.json

Safari

Enable developer mode in Safari preferences
Download the macOS app version from Releases
Open the app and enable the extension in Safari preferences

Development

# Install dependencies
npm install

# Build extension
npm run build

# Watch mode for development
npm run watch

# Run tests
npm test

Building for Production

# Build for all browsers
npm run build

# The dist/ folder contains the extension ready for loading

Project Structure

browser-extension/
├── src/
│   ├── background/    # Service worker / background script
│   ├── content/       # Content scripts injected into pages
│   ├── popup/         # Extension popup UI
│   ├── sidebar/       # AI chat sidebar
│   └── shared/        # Shared utilities
├── dist/              # Built extension
├── manifest.json      # Extension manifest (MV3)
├── package.json
└── tsconfig.json

Configuration

API Keys

The extension uses your Hanzo AI account for API access. Login at:

cloud.hanzo.ai - Cloud dashboard
iam.hanzo.ai - API key management

Or set environment variables for direct provider access:

ANTHROPIC_API_KEY - Claude models
OPENAI_API_KEY - GPT models
GOOGLE_API_KEY - Gemini models

Permissions

The extension requests minimal permissions:

activeTab - Access to current tab when activated
storage - Store settings and conversations locally
contextMenus - Right-click menu integration

Architecture

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│ Content Script  │ ◄──► │ Background       │ ◄──► │ Hanzo API       │
│ (Page Context)  │     │ (Service Worker) │     │ (api.hanzo.ai)  │
└─────────────────┘     └──────────────────┘     └─────────────────┘
         │                      │
         │                      │
         ▼                      ▼
┌─────────────────┐     ┌──────────────────┐
│ Popup / Sidebar │     │ MCP Bridge       │
│ (React UI)      │     │ (WebSocket)      │
└─────────────────┘     └──────────────────┘

ide-extension - VS Code and JetBrains plugins
hanzo-mcp - Model Context Protocol tools
hanzo.vim - Vim/Neovim plugin
hanzo.el - Emacs package

License

MIT - See LICENSE

4.7 KiB Raw Permalink Blame History