PGPAINLESS-CLI(1)

🌸 PGPAINLESS-CLI(1) — the PGPainless-CLI Manual, but make it bestie-coded 🌸

okay so. hi. welcome to the manual for pgpainless-cli, which the official docs call Stateless OpenPGP Protocol 💜. that's the NAME, that's the whole vibe. it's a CLI, it does OpenPGP, and it does it statelessly, which is a very main character way to live.

---

✨ SYNOPSIS ✨

pgpainless-cli [--stacktrace] [COMMAND]

that's it. that's the whole entrance. you either run it with a COMMAND or you get yelled at (gently, via exit code 19, more on that later 👀).

---

🦋 DESCRIPTION 🦋

so... the DESCRIPTION section is literally empty. the original manpage wrote the heading and then said absolutely nothing. it's giving mystery. it's giving enigmatic. no cap, there is genuinely no content here, so i'm not about to invent any — we move 💅.

---

💖 OPTIONS 💖

• --stacktrace — prints the stacktrace. that's it, that's the option. when things go feral, this is how you get the receipts 🫶.

---

👑 COMMANDS 👑

okay bestie, here's the roster. every single one, no skips:

• version — shows you version info about the tool. the "who am i" moment.
• list-profiles — spits out a list of profiles supported by the subcommand you identified. profile girlies rise ✨.
• generate-key — makes you a secret key 🔑. iconic. necessary. slay.
• change-key-password — updates the password on a key.
• revoke-key — generates revocation certificates. it's the breakup certificate 💔.
• extract-cert — pulls a public key certificate out of a secret key. like separating the public persona from the private life.
• sign — creates a detached message signature.
• verify — verifies a detached signature.
• encrypt — encrypts a message from standard input.
• decrypt — decrypts a message.
• inline-detach — splits signatures out of a clearsigned message.
• inline-sign — creates an inline-signed message.
• inline-verify — verifies an inline-signed message.
• armor — adds ASCII Armor to standard input 🛡️.
• dearmor — removes ASCII Armor from standard input.
• help — Stateless OpenPGP Protocol.
• generate-completion — Stateless OpenPGP Protocol.

not me pointing out that the last two are literally described as "Stateless OpenPGP Protocol" in the source. i'm not editing that, that's what it says, i'm just holding space for it 😭

---

💀 EXIT CODES 💀

this is the part where the program tells you how it's feeling. memorize these or keep the page open, your call 🍓:

• 0 — Successful program execution. the dream. the goal. periodt.
• 1 — Generic program error.
• 3 — Verification requested but no verifiable signature found.
• 13 — Unsupported asymmetric algorithm.
• 17 — Certificate is not encryption capable.
• 19 — Usage error: Missing argument.
• 23 — Incomplete verification instructions.
• 29 — Unable to decrypt.
• 31 — Password is not human-readable.
• 37 — Unsupported Option.
• 41 — Invalid data or data of wrong type encountered.
• 53 — Non-text input received where text was expected.
• 59 — Output file already exists.
• 61 — Input file does not exist.
• 67 — Cannot unlock password protected secret key.
• 69 — Unsupported subcommand.
• 71 — Unsupported special prefix (e.g. "@ENV/@FD") of indirect parameter.
• 73 — Ambiguous input (a filename matching the designator already exists).
• 79 — Key is not signing capable.
• 83 — Options were supplied that are incompatible with each other.
• 89 — The requested profile is unsupported, or the indicated subcommand does not accept profiles.

🚨 real talk, bestie: exit codes are how scripts find out something went wrong. 0 is the only happy one. everything else is a little cry for help. don't ignore them fr fr.

---

that's the whole page!! every option, every command, every exit code, untouched and accounted for 💖

cute sign-off time: this was the PGPainless-CLI Manual 🎀 — the manual name, folded in right at the top like i promised, and yes the page header said PGPAINLESS-CLI(1) and the footer said the same thing, so consider yourself fully oriented 🦋. no date was given on the page, so i'm not making one up — i would never 🫶. go forth, encrypt things, and remember: stateless is a lifestyle 💅✨