Lokale, privacy-first cookie-manager voor macOS. Leest browser-cookies op het systeem, categoriseert ze via een regel-laag + lokaal Ollama-model, en adviseert welke veilig opschoonbaar zijn — zonder ooit login/sessie-cookies te verwijderen.
- Alleen lezen, tenzij expliciet goedgekeurd. De app verwijdert nooit automatisch iets zonder dat de gebruiker dit per categorie heeft ingeschakeld en de veiligheidsregels het toestaan.
- Whitelist wint altijd. Cookies die op de hard-safelist staan (auth-patronen, gebruikerswhitelist, recente actieve sessies) worden nooit ter beoordeling aan het LLM aangeboden en nooit verwijderd.
- Lokaal en privacy-first. Geen cookie-inhoud verlaat het systeem. Classificatie gebeurt volledig via een lokale Ollama-instantie — en zelfs het LLM ziet alleen metadata (domein, naam, vlaggen), nooit cookie-waarden.
- Dubbele goedkeuring.
safeToCleanontstaat alleen bij overeenstemming tussen de regel-laag én het LLM. De safelist kan dit altijd blokkeren.
| Browser | Formaat | Toegang |
|---|---|---|
| Chrome / Brave | SQLite (metadata) | bestandstoegang; waarden worden niet ontsleuteld of gelezen |
| Safari | Cookies.binarycookies |
Full Disk Access (TCC) vereist |
| Firefox | cookies.sqlite |
Full Disk Access |
Crumb.app (SwiftUI, Dock + menu bar, non-sandboxed)
├── Core/
│ ├── Scanner/ CookieSource-protocol: ChromiumSource, SafariSource, FirefoxSource
│ ├── Categorization/ RuleEngine + gebundelde tracker-domeinenlijst (±50k, EasyPrivacy)
│ ├── Safety/ SafelistEngine + ProtectedCookieStore + DomainRulesEngine
│ ├── Insights/ RecommendationEngine (impact-sorteerde aanbevelingen) + InsightsEngine (score, diff, cross-browser, churn)
│ ├── LLM/ OllamaClient — batched, deterministic, met nette fallback
│ ├── Cleanup/ DeletionEngine + AutoCleanEngine + QuickCleanEngine + CookieBackup + AuditLog
│ ├── Scheduling/ LaunchAgentManager (RunAtLoad + instelbare frequentie)
│ ├── Logging/ JSONRunLog per run
│ └── Model/ CookieRecord, ScanRun, SnapshotStore (churn)
├── Crumb/
│ ├── Views/ Dashboard + aanbevelingen / Cookies (split view + detailpaneel) / Trends (privacy-score) / Instellingen
│ └── Resources/ AppIcon.icns + tracker-domeinenlijst
└── CrumbAgent CLI-binary in de app-bundle voor de launchd-agent
Project genereren en bouwen:
brew install xcodegen
xcodegen generate
open Crumb.xcodeproj # of: xcodebuild -scheme Crumb buildTests draaien:
xcodebuild -scheme Crumb test -destination 'platform=macOS'Lokaal installeren in /Applications:
xcodebuild -project Crumb.xcodeproj -scheme Crumb -configuration Release -derivedDataPath build/DerivedData build
codesign --force --deep --sign "Apple Development" build/DerivedData/Build/Products/Release/Crumb.app
cp -R build/DerivedData/Build/Products/Release/Crumb.app /Applications/
rm -rf build/- Start Crumb — bij de eerste start doorloop je een korte onboarding: privacybelofte, browserdetectie, Volledige Schijftoegang (indien nodig voor Safari) en optionele lokale AI. Daarna start de eerste scan. De app verschijnt in het Dock én in de menubalk; sluit je het venster, dan blijft Crumb actief in de menubalk.
- Safari vereist Volledige Schijftoegang: Systeeminstellingen → Privacy & Beveiliging → Volledige Schijftoegang → voeg Crumb toe → herstart Crumb. De app linkt hier naartoe in de onboarding en het Overzicht.
- Voor AI-classificatie: installeer Ollama en trek een model, bijvoorbeeld
ollama pull llama3.1:8b. Zonder Ollama draait alles op de regel-laag; het rapport vermeldt dan expliciet dat AI is overgeslagen.
- Home is een dashboard: privacy-status, hoofdactie "Veilig opschonen", aanbevelingen gesorteerd op impact (veilig op te ruimen, ouder dan 90 dagen, terugkerende trackers, top-trackingdomeinen), snelkeuzes en live scanvoortgang met per-browserstatus.
- Cookies is een split view: compacte lijst links (filterchips, sorteren op ouderdom/churn, bulk-whitelist) en een detailpaneel rechts met volledige uitleg, metadata, churn en acties (verwijderen, whitelist, alleen deze cookie beschermen, vergelijkbare cookies bekijken).
- Trends toont een privacy-score met uitleg, veranderingen t.o.v. de vorige run (nieuw/verdwijnen, trackerdruk in %), cross-browser duplicaten, churn-top en hardnekkige tracking-domeinen.
- Elk advies verklaart zichzelf: "Beschermd: naam bevat 'session'", "Review vereist: secure + httpOnly + jonger dan 24 uur", "Niet verwijderd: AI en regellaag zijn het niet eens", "Verwijderbaar: tracker, ouder dan 30 dagen, geen bescherming".
Op de Home-pagina biedt Crumb 4 interactieve snelkeuzes waarmee specifieke cookie-groepen in 1 klik veilig opgeruimd kunnen worden:
- Tracking & Marketing: verwijdert direct alle advertentie- en tracker-cookies.
- Oude Analytics (> 30d): ruimt analysecookies op die al meer dan een maand niet ververst zijn.
- Alles Opschoonbaar: verwijdert alle cookies die unaniem als
safeToCleanzijn beoordeeld. - Onbekend & verlopen: ruimt ongeclassificeerde cookies op die verlopen of sessiegebonden zijn.
Elke snelkeuze toont een live teller, vraagt expliciete bevestiging via een preview-sheet, controleert of actieve browsers gesloten zijn, en logt elke actie naar audit.jsonl.
- Auth-patronen (
session,token,sid,__Secure-,__Host-, …) → altijd vergrendeld. - Gebruikerswhitelist (bank, werk-SSO, e-mail) → altijd vergrendeld, los van elk advies. Invoer zoals
https://bank.nl/loginofWWW.Bank.nlwordt automatisch genormaliseerd naarbank.nl; import/export via Instellingen. - Recente actieve sessies (secure + httpOnly + jonger dan 24 uur) → maximaal
reviewSuggesteden nooit in bulk-voorselekten (snelkeuzes en auto-clean nemen deze cookies nooit mee). - Back-up vóór verwijdering. Elke verwijderingsactie schrijft eerst de volledige rijen weg naar een lokaal back-upbestand (alleen-lezen voor de eigenaar). Lukt de back-up niet, dan wordt er niet verwijderd. Herstellen kan via Instellingen → Back-ups (browser moet gesloten zijn); bewaartermijn instelbaar (7–365 dagen of voor altijd).
- Domeinregels. Fijnmaziger dan de whitelist: per domein altijd bewaren, altijd als tracking markeren, cookies ouder dan X dagen opschonen, of een specifieke cookienaam beschermen/opschonen — optioneel per browser. Beschermde cookies raken regels nooit.
- Handmatige cookie-bescherming. In het detailpaneel kan één specifieke cookie (domain|name|path) permanent beschermd worden.
- Auto-clean is opt-in per categorie met veiligheidskleppen: dry-run preview, limiet per run (standaard 100), optionele startdrempel ("pas opruimen bij minstens 20 veilige cookies") en instelbare agent-frequentie (1/3/6/12 uur). Elke verwijdering wordt geback-upt en gelogd; de agent-notificatie vermeldt ook het aantal geblokkeerde/mislukte cookies. Het audit-log is doorzoekbaar, filterbaar en exporteerbaar als CSV/JSON.
De gebundelde lijst (tracker-domains.txt, ±50.000 domeinen) combineert handmatige entries met domeinen uit EasyPrivacy. Bekende infrastructuur-/SSO-domeinen (Google, Apple, Microsoft, Okta, sociale platformen, …) worden nooit als tracker opgenomen. Bijwerken:
./scripts/update-tracker-list.shElke run schrijft een JSON-rapport naar ~/Library/Application Support/Crumb/logs/. Verwijderingen worden gelogd in audit.jsonl (wat, wanneer, welke regel/LLM-uitspraak). Rapporten en back-ups worden automatisch opgeruimd na 90 dagen; handmatig opruimen kan nog steeds via Instellingen.
# eenmalig: notarytool-profiel aanmaken
xcrun notarytool store-credentials CrumbNotary \
--apple-id "jij@example.com" --team-id VJ9D2C765N --password <app-specific password>
./scripts/build-release.shHet script bouwt Release, tekent met hardened runtime (inclusief de embedded CrumbAgent), dient in bij Apple-notarization en neemt het ticket op (staple). De app is niet sandboxed — distributie buiten de Mac App Store.
- Fase 1–3 — Scanner (Chrome, Brave, Safari, Firefox) + regel-laag + safelist
- Fase 4 — Ollama-classificatie met consensus-regels
- Fase 5 — Trends & run-geschiedenis
- Fase 6 — LaunchAgent (RunAtLoad + elke 3 uur)
- Fase 7 — Handmatige verwijdering + opt-in auto-clean + audit-log
- Fase 8 — Developer ID-signing + notarization (
scripts/build-release.sh) - Fase 9 — Verharding & beheer: dubbele goedkeuring afgedwongen, back-ups + herstellen, Safari-parser (canoniek binarycookies-formaat), trackerlijst via EasyPrivacy, whitelist-normalisatie, churn-detectie, log-/back-uprotatie, agent-notificaties, per-cookie acties, CI-releaseverificatie
- Fase 10 — Vertrouwen & inzichten: onboarding, dashboard met impact-gesorteerde aanbevelingen, cookie-detailpaneel, verklarende adviezen, scanvoortgang, domeinregels, auto-clean dry-run/limiet/drempel, instelbare planning, audit-log filteren/exporteren, privacy-score, cross-browser duplicaten, nieuw/verdwijnen-diff, handmatige cookie-bescherming
- Fase 9 — Homepage met interactieve snelkeuzes voor 1-klik opschonen
Ik ben Tiëndo, vrachtwagenchauffeur. Ik bouw dit project in mijn eentje, in de avonden naast fulltime werk. Vragen? Open een issue.
Dit project is gelicentieerd onder de MIT-licentie.