JobFoundryAGPL-3.0
GitHub
Docs/Companion Extension

Browser Extension Guide & Downloads

The JobFoundry companion extension extracts structured job postings directly from your authenticated browser session and securely transmits them to your local daemon.

Extension icon

Installation by Browser

  1. Download & Extract: Download jobfoundry-extension.zip and extract the contents to a folder on your computer (e.g., ~/Extensions/jobfoundry).
  2. Open Extensions: Navigate to chrome://extensions in your Chrome address bar.
  3. Enable Developer Mode: Toggle the Developer mode switch in the top-right corner.
  4. Load Unpacked: Click the Load unpacked button in the top-left corner and select the extracted folder.
  5. Pin Extension: Click the puzzle-piece icon in your browser toolbar and pin JobFoundry for 1-click job ingestion.
  1. Download & Extract: Download and unzip jobfoundry-extension.zip.
  2. Open Extensions: Navigate to brave://extensions.
  3. Enable Developer Mode: Turn on the Developer mode toggle in the top-right.
  4. Load Unpacked: Click Load unpacked and select the directory containing manifest.json.
  5. Brave Shields Compatibility: JobFoundry communicates exclusively with your local daemon (http://localhost:8080). No special Shields exceptions are required.
  1. Download & Extract: Extract jobfoundry-extension.zip.
  2. Open Extensions: Navigate to edge://extensions.
  3. Enable Developer Mode: In the left sidebar, switch on Developer mode.
  4. Load Unpacked: Click Load unpacked and select the unzipped folder.
  1. Download & Extract: Extract the extension package.
  2. Open Debug Add-ons: Navigate to about:debugging#/runtime/this-firefox in your address bar.
  3. Load Temporary Add-on: Click Load Temporary Add-on....
  4. Select Manifest: Select the manifest.json file in your extracted extension folder.

Permissions & Privacy Transparency

JobFoundry values user privacy. The extension requests only the strictly necessary browser permissions:

PermissionPurpose
activeTabAllows reading job description DOM elements on the current tab when you click "Save Job" or visit a supported job page.
storageStores your local daemon URL (defaults to http://localhost:8080) and user preference tokens.
http://localhost:8080/*Direct communication channel to transmit parsed job payloads to your local JobFoundry server.
✓No Remote Servers

The companion extension never transmits job data, cookies, browsing history, or analytics to any external cloud service or third party. All network traffic is strictly between your browser and your local daemon.

Pairing & Connection Test

After loading the extension, click the JobFoundry icon in your browser toolbar to open the popup. The status indicator should display CONNECTED to http://localhost:8080.

If the status reads Disconnected:

  • Verify that the daemon is running with curl http://localhost:8080/health.
  • If your daemon is running on a different port or host, click Settings in the extension popup and update the Daemon Endpoint URL.