English · 日本語 · 한국어

🔖 Bookmark Scout

A modern browser extension to search, organize, and save bookmarks. Powered by AI folder recommendations with multi-provider support.

---

📚 Documentation

Visit https://docs.bookmark-scout.com for comprehensive documentation:

• Getting Started — Installation and setup guides
• Features — Detailed feature documentation
• Contributing — How to contribute to the project

---

🌐 Website

Visit https://bookmark-scout.com for the landing page and download links.

---

🌐 Browser Support

Browser	Support Level	Notes
	⭐⭐⭐ Primary	Manifest V3, all features
	⭐⭐ Secondary	Manifest V2, sidebar not available
	⭐⭐ Secondary	Chromium-based, full compatibility
	❌ None	bookmarks API not implemented

Why Safari? Safari Web Extensions do not support the browser.bookmarks API, which is essential for this extension's core functionality.

---

✨ Features

✅ Implemented

• 🤖 AI Folder Recommendations — Smart folder suggestions powered by OpenAI, Anthropic, or Google AI
• 🔍 Instant Search — Quickly find bookmarks with debounced search and folder filtering
• 📂 Drag & Drop — Organize bookmarks and folders with intuitive drag-and-drop
• ⚡ Quick Add — Save the current tab to any folder with one click
• 📱 Side Panel — Access your bookmarks from Chrome's side panel
• 🎯 Expand/Collapse All — Quickly expand or collapse nested folders
• 📁 Create Folders — Create new folders directly from the popup
• 🗑️ Delete Items — Remove bookmarks and folders with confirmation
• 🌍 i18n — English, Japanese, and Korean language support
• 🔄 Bookmark Sync — Cross-device bookmark sync via browser's built-in sync

🤖 AI Features Disclaimer

AI-powered folder recommendations are disabled by default and require manual opt-in:

1. Go to Settings → AI tab
2. Enable AI features and select your preferred provider (OpenAI, Anthropic, or Google)
3. Enter your own API key from your provider's dashboard

⚠️ Note: This feature uses third-party AI services. Your bookmark titles and URLs are sent to the selected AI provider for processing. API usage may incur costs depending on your provider's pricing. Results are experimental and may vary in accuracy.

🚧 Roadmap

• 🗂️ Full Bookmarks Manager — Replace Chrome's default bookmarks page
• ⚙️ Options Page — Customize extension settings
• 🌙 Dark Mode — Beautiful dark theme with smooth transitions
• ⚙️ Settings Sync — Sync extension preferences across devices
• 🔗 Duplicate Detection — Find and remove duplicates
• 💀 Dead Link Checker — Detect broken links
• 📤 Import/Export — Backup bookmarks as JSON

---

🛠️ Tech Stack

Framework & Language

Technology	Version	Description
	19.2	UI library
	5.9	Type-safe JavaScript
	15	Website framework

Build & Tooling

Technology	Version	Description
	0.20	Extension framework
	7	Build tool
	22.3	Monorepo management
	1.3	JavaScript runtime
	2.3	Linting & formatting

UI & Styling

Technology	Version	Description
	4.1	Utility-first CSS
	0.9	Radix-based components
	1.2	Headless UI primitives
	12.23	Animation library
	0.562	Icon library

State & Data

Technology	Version	Description
	5.0	State management
	8.21	Headless table library
	1.7	Drag & drop

Deploy & Infrastructure

Technology	Version	Description
	-	CI/CD & hosting
	-	CDN & DNS

---

📦 Installation

From GitHub Releases

Download the latest release from GitHub Releases:

# Download latest release using GitHub CLI
gh release download --repo isandrel/bookmark-scout --pattern "*.zip"

# Extract the zip file
unzip bookmark-scout-chrome-*.zip -d bookmark-scout

From Source

# Clone the repository
gh repo clone isandrel/bookmark-scout
cd bookmark-scout

# Install dependencies
bun install

# Build the extension
bun run build

Load in Chrome

1. Open chrome://extensions/
2. Enable Developer mode (top right)
3. Click Load unpacked
4. Select apps/extension/.output/chrome-mv3

---

🚀 Development

# Start extension dev server
bun run dev

# Start website dev server
bun run dev:website

# Build all
bun run build:all

# Lint
bun run lint

---

📁 Project Structure

bookmark-scout/
├── apps/
│   ├── extension/          # Browser extension (WXT)
│   │   ├── src/
│   │   │   ├── components/ # React components
│   │   │   ├── entrypoints/ # popup, sidepanel, options, bookmarks
│   │   │   ├── hooks/      # Custom React hooks
│   │   │   ├── stores/     # Zustand stores
│   │   │   └── services/   # Bookmark API services
│   │   └── wxt.config.ts
│   └── website/            # Next.js marketing site
│       └── app/
├── packages/
│   └── config/             # Shared configuration
├── config/
│   └── site.config.toml    # Central config file
└── templates/              # README templates

---

🔐 Permissions

Permission	Purpose
bookmarks	Read and write bookmarks
tabs	Get current tab info for quick-add
favicon	Display website favicons
storage	Save user preferences
sidePanel	Enable Chrome side panel

---

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

# Fork and clone the repository
gh repo fork isandrel/bookmark-scout --clone

# Create your feature branch
git checkout -b feature/amazing-feature

# Make your changes and commit
git commit -m 'feat: add amazing feature'

# Push and create a pull request
git push origin feature/amazing-feature
gh pr create --title "feat: add amazing feature"

---

📄 License

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details.

---

⭐ Star History

---

Made with ❤️ by isandrel