Privelin docs

Setup, extension loading, demonstration script, and coverage notes. Full handoff lives in the repository README.

Quick start

npm install
npm run build
npm run dev:web          # http://localhost:3411
# Chrome:  apps/extension/dist
# Firefox: apps/extension/dist-firefox

Load the extension

Chrome / Chromium

  1. Open chrome://extensions → enable Developer mode
  2. Load unpacked → select apps/extension/dist
  3. Open the Privelin popup once — it auto-connects to the local dashboard
  4. Visit the playground, ChatGPT, or Claude

Firefox (121+)

  1. Open about:debugging#/runtime/this-firefox
  2. Temporary Extensions → Load Temporary Add-on…
  3. Select apps/extension/dist-firefox/manifest.json
  4. Open the Privelin popup once, then use playground / ChatGPT / Claude

Firefox temporary add-ons unload when the browser restarts; reload from dist-firefox after each restart. Profile email attribution uses Chrome identity only; Firefox audits fall back to device id.

Synthetic examples

  • Email: demo.user@example.com
  • Card: 4111-1111-1111-1111 (Luhn-valid test PAN)
  • Secret: DEMO_SECRET_ABCDEFGHIJKLMNOP12
  • Marker: CONFIDENTIAL_INTERNAL