Browser history is a list. Curiosity is a path.
Rabbit Hole is a Chrome extension that follows one curiosity trail at a time (the tab you start in, plus the tabs that open from it), draws it as a map, and writes a reading of what came back across trails. It started as a question: curiosity leaves no record, so what if it could?
Status: personal project, prototype. Capture, the map and a code-made report work. An optional Claude step that names threads across trails is not built yet.
chrome://extensions and turn on Developer mode.extension/ folder.After changing code, press the reload arrow on the extension card. Chrome does not pick up edits on its own.
chrome.storage.local). Nothing is sent anywhere. The extension requests no site access.extension/
manifest.json Manifest V3. Permissions: tabs, webNavigation, storage, unlimitedStorage, sidePanel, alarms, idle
background.js Capture engine: lineage, time on page, trail lifecycle
common.js Shared helpers: URL scrubbing, skip list, titles
analyze.js The code-made report: counts, sittings, returning words, loose ends (pure functions)
panel.* Side panel: start, pause, surface
book.* The map and settings
report.* The reading page
art.js, *.css Botanical drawings and the romantic-academia theme (fonts bundled locally)
tests/
run.py, run2.py Real-Chromium checks of capture (Playwright, headless)
analyze-check.js Prints what the report layer finds in an export
pip install playwright && playwright install chromium
python3 tests/run.py # lineage, skip list, pause, surface
python3 tests/run2.py # returns, SPA titles, junk titles
node tests/analyze-check.js path/to/your-export.json
Exports from the book are your browsing history. They are ignored by .gitignore, and should not be committed or posted.
docs/ is a static example of the book and the report, served by GitHub Pages. It runs the real extension pages on a set of
sample trails built from public pages, with notes removed and personal paths cleaned (tools/make-sample.py).
tools/build-demo.py rebuilds it from extension/, so the example always matches the code.