DEV Community

Lakshmi Sravya Vedantham
Lakshmi Sravya Vedantham

Posted on

I Built a Breach Monitoring System That Runs in Your Terminal

#security #privacy #python #opensource

I Built a Breach Monitoring System That Runs in Your Terminal

Most people check if they've been breached once, maybe twice. Then they forget about it. Meanwhile, new breaches happen every week.

I built leakwatch — a personal breach monitoring system that watches your accounts continuously and only alerts you when something new happens.

What it does 

pip install leakwatch

# Add accounts to your watchlist
leakwatch watch personal@gmail.com
leakwatch watch work@company.com
leakwatch watch your_username

# Scan for new breaches
leakwatch scan
Enter fullscreen mode Exit fullscreen mode

The key word is new. leakwatch remembers what it has already told you about. It only alerts on breaches it has not seen before.

The dashboard 

leakwatch dashboard
Enter fullscreen mode Exit fullscreen mode

Shows your watchlist, new alerts with severity scores (1-10), pending actions, and overall stats. Everything in a clean terminal UI.

How it is different from Have I Been Pwned

Feature HIBP leakwatch
Check email Yes Yes
Check username No Yes
Remember previous results No Yes
Only show NEW breaches No Yes
Generate action plan No Yes
Track your progress No Yes
Severity scoring No Yes (1-10)
Works offline No Yes

Action tracking

Every breach generates prioritized actions. CRITICAL for password leaks, HIGH for PII exposure, MEDIUM for email-only leaks.

leakwatch actions
leakwatch done 3
leakwatch status
Enter fullscreen mode Exit fullscreen mode

Password checker 

leakwatch check-password
Enter fullscreen mode Exit fullscreen mode

Uses k-anonymity. Only 5 characters of the hash leave your machine.

Everything stays local

Built-in database of 30+ major breaches. Optional HIBP API key for real-time data. SQLite for all tracking. No cloud, no accounts, no telemetry.

Try it 

pip install leakwatch
leakwatch watch your-email@gmail.com
leakwatch scan
leakwatch dashboard
Enter fullscreen mode Exit fullscreen mode

GitHub: github.com/LakshmiSravyaVedantham/leakwatch

This completes my privacy tools trilogy:

  1. trackmap — map which companies track your browsing
  2. phantom — find ghost accounts on breached services
  3. leakwatch — monitor your accounts for new breaches

All open source. All fully local. All pip-installable.

Want all three in a single binary?

I rewrote trackmap + phantom + leakwatch as one Rust binary: privacykit

cargo install privacykit
privacykit track scan --chrome
privacykit phantom scan you@gmail.com
privacykit leak scan
Enter fullscreen mode Exit fullscreen mode

Zero Python. Zero dependencies. One binary.

Top comments (0)