tidaldb/applications/forage/extension

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://)