Installation

ClueLens works in Chrome, Edge, other Chromium-based browsers, and Firefox. You can install it from the browser stores, load it manually, or build it from source.

Install from a store

Browser	Link
Chrome / Edge	Chrome Web Store
Firefox	Firefox Add-ons

After installation the extension is enabled automatically, and you can start using it on any web page.

Manual install from Releases

Download the latest release from GitHub Releases.

Chrome / Edge / Chromium

1. Download and extract cluelens-xxx-chrome.zip
2. Open chrome://extensions in Chrome or edge://extensions in Edge
3. Enable Developer mode
4. Click Load unpacked
5. Select the extracted folder

Firefox

1. Download cluelens-xxx-firefox.xpi or extract the .zip
2. Open about:debugging#/runtime/this-firefox
3. Click Load Temporary Add-on...
4. Select manifest.json from the extracted folder

TIP

Manually installed builds may need to be reloaded after the browser restarts. Store installs are recommended if you want automatic updates.

Build from source

Requirements

• Node.js 18+
• Yarn 1.x

Steps

# Clone the repository
git clone https://github.com/cppakko/cluelens.git
cd cluelens

# Install dependencies
yarn install

# Run in development mode (Chrome)
yarn dev

# Run in development mode (Firefox)
yarn dev:firefox

# Production build
yarn build

# Production build (Firefox)
yarn build:firefox

Build outputs are generated in the .output/ directory. Load them with the manual installation steps above.

Next

After installation, continue with Getting Started.