PWNDCK(1)

okay bestie, sit down, hydrate, and let me tell you about pwndck(1) — yes that's the manual name, section 1, filed under General Commands Manual because it's a whole command-line icon 💅. she checks your passwords against the HaveIBeenPwned leak database and she does NOT miss. periodt.

---

💖 NAME 💖

pwndck — check passwords against the HaveIBeenPwned leak database 🦋

---

✨ DESCRIPTION ✨

here's the usage vibe, bestie, straight up, no notes:

usage: pwndck [-q] [ [password ...]  | -i INPUT | -e | --version | -h ]

and what does she do? report # of password hits in HaveIBeenPwned 🎯 that's the whole assignment.

🧸 positional arguments:

• password — the password(s) to check 💜 drop 'em right in, she'll take one or a whole lil' squad of them.

🎯 options:

• -q, --quiet — suppress output 🤫 she does the work, she just doesn't talk about it. mysterious. main character energy.
• -i, --input INPUT — a file containing passwords, one per line ('-' for stdin) 📄 literally point her at the file and she'll go through every single line, or pass - and she'll sip from stdin like a straw.
• -e, --estimatedb — estimate the current size of the HaveIBeenPwnd password database 👑 (yes, spelled HaveIBeenPwnd right there in the original, not me being sloppy, iykyk). she'll guess how big the whole thing is rn.
• --version — show program's version number and exit 🎀 she says her name and dips.
• -h, --help — show this help message and exit ✨ the classic. the iconique.

---

okay now the actual lore, fr fr 🌸

Evaluate one or more passwords against the HaveIBeenPwned password database, and return the number of accounts for which they have been reported as compromised. that's the whole point of her existence and she's obsessed with it.

The number of entries found in the database is returned. and if multiple passwords are being checked, the password name is also returned too, so you know which one is giving "i was in a breach" 🫶.

If the password is not specified on the command line, and there is no std input, the user will be prompted. so don't panic if you forget — she will literally ask you, politely, like a good bestie 💜.

and here's the dramatic part, and i mean dramatic: the command returns with an error code if a password is found in the database. 😭 so heads up! a non-zero exit = your password is out there. it's giving found footage.

The process_pw() function is available for use in Python. it can be accessed by importing it from the pwndck module 🐍 so if you're a python girlie you can just import her and reuse the whole vibe. slay.

See https://haveibeenpwned.com/API/v3#PwnedPasswords — that's where the API tea lives, go read it, it's iconic ☕

---

real talk bestie: never pipe your actual passwords through a random script you haven't read, but if you're gonna do it, at least read this page first 💅

---

okay that's the whole page!! love u, stay safe, use a password manager, bye 🎀✨

pwndck(1) — February 2026, straight out of the General Commands Manual, version vibes and all. mwah. 💖🌸