Installation and startup

Requirements

• Node.js and npm
• A Chromium-based browser or Firefox
• Optional access to an AI provider or a local model

Build the extension

Run all commands from the repository root.

npm install
make chrome
make firefox

Outputs are written to:

• dist/chrome
• dist/firefox

Downloads

• Chrome extension (ZIP)
• Firefox extension (XPI)

Load in Chrome

1. Open chrome://extensions/
2. Enable developer mode
3. Choose Load unpacked
4. Select dist/chrome

Alternatively, download the ZIP file from the latest GitHub release and unpack it locally.

Load in Firefox

For local testing you can load the extension temporarily:

1. Open about:debugging#/runtime/this-firefox
2. Choose Load Temporary Add-on
3. Open dist/firefox/manifest.json

For release builds, you can download the XPI file from the latest GitHub release instead.

Watch mode for development

npm run dev

This runs vite build --watch --mode chrome.