README.org

local-only browser history tracker. a webextension plugin and a local http server. logs each page you visit to a plaintext org-mode file at ~/.crumb/history.org.

• browser extension (webextension api, javascript)
• local http listener (python + flask)
• plaintext log (~/.crumb/history.org)

on each page load the extension posts page metadata to the local server, which appends it to the log. captured: title, url, utc timestamp, hostname, path, and optionally query string, tab id, window id, favicon url.

python 3.x, flask, a chromium or firefox browser with extension developer mode.

1. start the listener:

python3 -m venv venv
source ./venv/bin/activate
pip install -r requirements.txt
python server.py

1. load the extension: enable developer mode, load crumb_extension/.
2. browse. entries land in ~/.crumb/history.org.
3. search:

python search.py <term>

• extensions can't write files directly; the local server does it.
• the log is plaintext, not encrypted. bolt on your own if needed.
• data stays local. nothing is sent anywhere.

0bsd. see LICENSE.