# karlicoss/promnesia

Another piece of your extended mind

Repository: https://github.com/karlicoss/promnesia
Canonical: https://ross.abutalabs.com/products/promnesia
Homepage: https://beepb00p.xyz/promnesia.html
Language: Python
License: MIT
License Family: permissive
Topics: personal-knowledge-database, pkm, mind, browser-history, memory, extended-mind, memex
Last push: 2026-08-07T20:43:54+00:00

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 54, longevity 100
- inputs: {"age_days": 2706, "days_push": 26, "days_rel": 148, "gap_med": 178, "n_releases_24m": 4}
- flags: no_readme
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1895, forks 79 (observed 2026-08-28T04:05:50.900918+00:00)

## What it is
Promnesia is a browser extension plus Python backend that enhances browsing history by annotating visited pages with context from multiple sources like browser history, annotations, and personal notes. It acts as a 'web surfing copilot' that integrates your browsing with your personal knowledge base.

## Use cases
- see which pages I already visited and when while browsing
- annotate web pages with notes from my knowledge base
- search across my scattered browser history from multiple devices
- build a personal memex from my digital trace
- highlight pages I've saved or visited before
- import browser history from Chrome, Firefox, and mobile browsers

## When to choose
- you want a self-hosted, privacy-respecting alternative to cloud history services
- you keep a personal wiki or notes and want them linked to your browsing
- you need to unify history from multiple browsers and devices

## When to avoid
- you just want simple built-in browser history without setup
- you prefer a fully managed cloud service with zero configuration
- you don't want to run a Python backend server

## Facets
- artifact type: application
- maturity: active
- function: search-engine, web-scraping, browser-extension, developer-tools, self-hosted
- domain: developer-tools, privacy, self-hosted
- platform: python, browser, browser-extension, cross-platform, self-hosted, windows
- tags: personal-knowledge-management, browser-history, extended-mind, memex, pkm, quantified-self, search, linux, macos

## Member repositories
- karlicoss/promnesia (main) score 82

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:50.900918+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:12:51.538342+00:00, confidence not recorded.
  - homepage: https://beepb00p.xyz/promnesia.html (fetched 2026-08-29T10:51:49.299182+00:00, sha 2f1c7ca457ad)
  - registry_pypi: https://pypi.org/pypi/promnesia/json (fetched 2026-08-29T10:51:49.302644+00:00, sha 6f66443eea3f)
- Data as of 2026-08-30T08:39:29.467469+00:00.