How wslyvh/paperweight works
Paperweight is a local-first desktop app that scans connected email to inventory accounts and mailing lists, surface breaches and personal data, and support cleanup and privacy requests. Its primary workflow runs from connecting a mailbox through sync and analysis to reviewing results and taking actions; paid access also exposes those capabilities through MCP. The graph includes the documented website breach surface as a secondary capability. Some service-to-analysis and UI-to-main-process wiring is not shown in the excerpts, so those relationships are omitted or marked unverified.
Main entry points: account.ts Account service · server.ts MCP server · db.ts Local database · index.ts Mail analysis
Components 21
Desktop experience
- App routes
src/renderer/App.tsx - Settings and license
src/main/services/settings.ts
Mailbox and analysis
- Account service
src/main/services/account.ts - Mail providers
src/main/providers - Sync manager
src/main/sync-manager.ts - Analysis service
src/main/services/analysis.ts - Mail analysis
analysis/src/index.ts - PII detectors
analysis/src/detect/index.ts - Mail classification
analysis/src/classify/type.ts - Unsubscribe detection
analysis/src/classify/unsubscribe.ts - Messages
src/main/services/messages.ts - Local database
src/main/db.ts - Global database
src/main/globalDb.ts - Schema migrations
src/main/migrations.ts
Privacy actions
- Account inventory
src/main/services/vendors.ts - Privacy cases
src/main/services/cases.ts - GDPR actions
src/main/services/gdprActions.ts - Personal data
src/main/services/pii.ts
External interfaces
- MCP server
src/mcp/server.ts - Breach information
website/src/app/api/breaches/route.ts
Other components
- User
Connections 20
- User → App routes: uses
README.md - Account service → Mail providers: selects provider
src/main/services/account.ts - Account service → Sync manager: starts sync
src/main/services/account.ts - Account service → Messages: uses
src/main/services/account.ts - Account service → Account inventory: uses
src/main/services/account.ts - Account service → Local database: uses
src/main/services/account.ts - Sync manager → Analysis service: invokes
src/main/sync-manager.ts - Analysis service → Local database: uses
src/main/services/analysis.ts - Analysis service → Account inventory: uses
src/main/services/analysis.ts - Mail analysis → PII detectors: detects data
analysis/src/index.ts - Mail analysis → Mail classification: classifies mail
analysis/src/index.ts - Mail analysis → Unsubscribe detection: resolves links
analysis/src/index.ts - Local database → Global database: configures path
src/main/db.ts - Local database → Schema migrations: runs migrations
src/main/db.ts - MCP server → Settings and license: checks license
src/mcp/server.ts - MCP server → Privacy cases: registers case tools
- MCP server → Account inventory: queries inventory
- MCP server → Personal data: queries personal data
- User → MCP server: connects agent
README.md - User → Breach information: checks breach alerts
README.md