AI-Powered Browser Workspace for Bookmarks, Tabs, and Collections
Product Introduction • Usage • 中文文档 • 使用文档 • Features • Development • Contributing
HamHome is an AI-powered browser workspace for modern browsing. It brings together bookmark management, saved tab workspaces, and automatic tab grouping so you can organize both long-term knowledge and in-progress browsing in one place.
Use HamHome to save, manage, and restore tabs that are already open in your browser, automatically group active tabs by rules or AI, and turn valuable pages into structured bookmarks with AI-generated summaries, categories, tags, and semantic search. Your data stays local-first, portable, and syncable across devices when you need it.
👉 View Product Introduction - Learn more about features and capabilities
| Side Panel | Save Panel |
|---|---|
 |
 |
| Semantic Search | Preset Categories |
 |
 |
| Management Page | Settings Page |
 |
 |
| Workspaces | Tab Group Rules |
| 【待补充】 | 【待补充】 |
| Full Data Backup | WebDAV Sync |
| 【待补充】 | 【待补充】 |
- Save open tabs as restorable workspaces for research, projects, and recurring browsing sessions
- Preserve native browser Tab Groups when saving and restoring supported browser sessions
- Organize workspaces with separate workspace categories and tags
- Analyze workspace pages to detect duplicates and recommend pages worth converting into long-term bookmarks
- Create automatic Tab Group rules by domain, URL, title, case-insensitive title, or regex
- Configure target group title, color, collapsed state, and multiple match conditions
- Optional AI auto-grouping uses your configured AI provider and caches results for repeated pages
- Auto-categorization based on page content
- Smart tag suggestions with configurable presets
- AI-generated summaries for quick reference
- Semantic and conversational search for saved bookmarks
- BYOK (Bring Your Own Key) support for OpenAI, Anthropic, Claude, Ollama, and custom endpoints
- Support synchronization via WebDAV (e.g., Nextcloud, InfiniCLOUD, etc.)
- Sync bookmarks, categories, settings, workspaces, workspace categories, and Tab Group configuration
- End-to-end encrypted or plain data sync options
- Real-time sync status widget in the header
- Granular control over remote data (clear remote data anytime)
- Icon Support: Add emoji icons to your categories for better visual identification.
- Preset Schemes: Two built-in category templates—"General" and "Professional Creator"—with one-click import
- AI-Generated Categories: Describe your use case and let AI create a tailored category structure
- Unlimited hierarchical category tree
- Save complete HTML snapshots locally (IndexedDB)
- Access content even when the original page goes offline
- Powered by Mozilla Readability for clean extraction
- Full-text search across titles, descriptions, and content
- Semantic search (vector-based)
- Filter by category, tags, and time range
- Create custom filter presets for complex queries
- JSON backups include bookmarks, categories, workspaces, workspace categories, Tab Group rules, and auto-group settings
- JSON restore remaps category relationships and updates existing workspaces or Tab Group rules when IDs already exist
- HTML import/export supports standard browser bookmark files for Chrome, Firefox, and Edge
- Local-First: All data stored locally in Chrome Storage + IndexedDB
- Granular Storage Management: View and manage space used by bookmarks, snapshots, and vector data separately.
- Selective Deletion: Delete specific data types (e.g., only snapshots) while keeping your categories and configurations.
- Privacy Domains: Configure domains to exclude sensitive sites from AI analysis
- Grid (masonry) and list view modes
- Light/dark theme with system preference detection
- Full i18n support (English & Chinese)
- Keyboard shortcuts and edge-trigger panel
| Browser | Status |
|---|---|
| Chrome / Chromium | ✅ Manifest V3 |
| Microsoft Edge | ✅ Manifest V3 |
| Firefox | ✅ Manifest V2/V3 |
- Chrome Web Store
- Firefox Add-ons
- Microsoft Edge Addons
- See releases to download and install manually.
# Clone the repository
git clone https://github.com/bingoYB/ham_home.git
cd ham_home
# Install dependencies (requires pnpm)
pnpm install
# Build for Chrome/Edge
pnpm --filter extension build
# Build for Firefox
pnpm --filter extension build:firefox- Chrome/Edge: Navigate to
chrome://extensions/, enable "Developer mode", click "Load unpacked", and selectapps/extension/.output/chrome-mv3 - Firefox: Go to
about:debugging, click "This Firefox", click "Load Temporary Add-on", and selectapps/extension/.output/firefox-mv2/manifest.json
# Start dev server (Chrome)
pnpm --filter extension dev
# Start dev server (Firefox)
pnpm --filter extension dev:firefox
# Build all browser variants
pnpm --filter extension build:all
- Framework: WXT (Vite-based extension framework)
- UI: React 19 + TypeScript + Tailwind CSS
- Components: shadcn/ui
- Content Extraction: Mozilla Readability + Turndown
- i18n: i18next + react-i18next
- Storage: Chrome Storage API + IndexedDB
ham_home/
├── apps/
│ └── extension/ # Browser extension
│ ├── components/ # React components
│ ├── hooks/ # Custom hooks
│ ├── lib/ # Core libraries (AI, storage, i18n)
│ ├── entrypoints/ # Extension entry points
│ └── locales/ # i18n resources
├── packages/
│ ├── ui/ # Shared UI components
│ ├── types/ # Shared TypeScript types
│ └── ... # Other shared packages
└── docs/ # Documentation
Contributions are welcome! Please:
- Fork this repository
- Create a feature branch (
git checkout -b feature/your-feature) - Commit your changes (
git commit -m 'Add your feature') - Push to the branch (
git push origin feature/your-feature) - Open a Pull Request
If you find HamHome useful, consider giving it a ⭐