tidaldb/applications/forage/extension/README.md
2026-02-23 22:41:16 -07:00

1.5 KiB

Forage Chrome Extension

Automatically captures browsing signals for your Forage personalized feed without needing to manually inject JavaScript.

Install (3 steps)

  1. Open Chrome and navigate to chrome://extensions
  2. Enable Developer mode (toggle in the top-right corner)
  3. Click Load unpacked and select the applications/forage/extension/ directory

The Forage icon will appear in your toolbar. Click it to configure the server URL, user ID, and optional auth token.

How it works

  • Content script runs on every page at document_idle, reads the page title, URL, canonical URL, description, and word count, then sends a capture message to the background worker.
  • Background worker POSTs to /capture (registering the page as a Forage item and firing a view signal) and /signal (for dwell events after 30 seconds).
  • Popup lets you configure the server URL, user ID, auth token, and enable/disable capture. Shows the last captured page title.

Configuration

Field Default Description
Server URL http://localhost:4242 Forage server address
User ID 1 Which Forage user to signal as
Token (empty) Bearer token if the server was started with --token
Enable capture Toggle to pause/resume without uninstalling

Skipped pages

The extension never captures:

  • chrome:// internal pages
  • localhost and 127.0.0.1 addresses (avoids capturing the Forage UI itself)
  • Extension pages (chrome-extension://, moz-extension://)