Copus Browser Extension

Save what resonates as you browse. Build a taste graph you own, share it with anyone, and connect it to your AI.

Install

• Chrome / Brave / Edge: Chrome Web Store
• Firefox: Firefox Add-ons

Features

• Quick Save — Save any webpage to your Copus treasury with one click or Alt+Shift+S
• Sidebar — Browse your collections, traces, and recommendations without leaving the page (Alt+Shift+E)
• AI Chat Integration — Works with ChatGPT, Claude, Gemini, Perplexity, DeepSeek, Grok, Mistral, and HuggingFace Chat
• Smart Metadata — Automatically extracts page title, description, and cover images
• Context Menu — Right-click to save pages or selections

Development

From Source

1. Clone and build:

   git clone https://github.com/copus-io/copus-network-browser-extension.git
   cd copus-network-browser-extension
   bash build.sh

2. This creates separate builds in build/:

   • build/chrome/ — Chrome/Chromium build
   • build/firefox/ — Firefox build

3. Load in your browser:

   • Chrome: Go to chrome://extensions/, enable Developer mode, click "Load unpacked", select build/chrome/
   • Firefox: Go to about:debugging#/runtime/this-firefox, click "Load Temporary Add-on", select build/firefox/manifest.json

Project Structure

├── manifest.json            # Chrome manifest (MV3)
├── manifest.firefox.json    # Firefox manifest (MV3, gecko settings)
├── build.sh                 # Build script for both browsers
├── background.js            # Service worker
├── contentScript.js         # Content script (all pages)
├── aiChatHelper.js          # AI chat platform integration
├── sidepanel.js/html/css    # Sidebar UI
├── quicksave.js/html/css    # Quick save popup
├── taste-icon.png           # Floating action button icon
└── icons/                   # Extension icons (16, 32, 48, 96, 128)

Chrome vs Firefox

Both browsers share the same source code. The differences are in the manifests:

	Chrome (manifest.json)	Firefox (manifest.firefox.json)
Background	service_worker	scripts array
Sidebar	side_panel API	sidebar_action API
Browser settings	—	browser_specific_settings.gecko

The build.sh script handles copying the correct manifest for each build.

API

The extension communicates with the Copus backend:

• Production: https://api-prod.copus.network/copusV2
• Test: https://api-test.copus.network/copusV2

Environment is auto-detected based on the domain.

Contributing

See CONTRIBUTING.md for details.

License

MIT — see LICENSE.

Links

• Copus Website
• Report Issues

---

Made with care by the Copus team