POP(1)

📦
version 0.5.0 · 2 versions
, in nixpkgs unstable

💌 POP(1): pop — send emails from your terminal 💌

okay bestie, this is POP(1), the manual for pop — your terminal’s little email-sending icon. No cap, it’s giving “I send emails and I look cute doing it.” 💅

✨ NAME ✨

pop — send emails from your terminal. Short, iconic, to the point. 🎀

🌸 SYNOPSIS 🌸

pop [options...] [argument...]

That’s the whole shape of it, bestie. ✨

💅 DESCRIPTION 💅

okay so pop is a tool for sending emails from your terminal. Literally that’s the vibe. 🦋

Run with no arguments to launch the interactive TUI, or send email non-interactively on the CLI by providing all required flags:

pop < message.md \
    --from me@example.com \
    --to you@example.com \
    --subject "Hello, world!" \
    --attach invoice.pdf

See pop skill for a full skill definition for AI agents. iykyk 🤖✨

🎀 OPTIONS 🎀

  • -a, --attach — the email’s attachments. files go here, bestie 🍓
  • --bcc — BCC recipients. sneaky lil copy list 🙈
  • -b, --body — the email’s contents. the main character text 💌
  • --cc — CC recipients. the “keep them in the loop” girlies 🌀
  • -f, --from — the email’s sender — env var: ($POP_FROM). who’s sending this masterpiece? 💖
  • --oauth — use OAuth for Resend authentication — env var: ($POP_OAUTH_RESEND). auth, but make it OAuth 🔐
  • --plaintext — whether to send email in plaintext. no fancy business 📝
  • --preview — whether to preview the email before sending. always do a vibe check 👀
  • -r, --resend.key — API key for Resend.com — env var: ($RESEND_API_KEY). the keys to the kingdom 🔑
  • -x, --signature — signature to display at the end of the email. — env var: ($POP_SIGNATURE). sign it, slay it, send it ✍️
  • -e, --smtp.encryption — encryption type of the SMTP server (starttls, ssl, or none) — env var: ($POP_SMTP_ENCRYPTION). pick your encryption flavor 🛡️
  • -H, --smtp.host — host of the SMTP server — env var: ($POP_SMTP_HOST). where the SMTP server lives 🏠
  • -i, --smtp.insecure — skip TLS verification with SMTP server — env var: ($POP_SMTP_INSECURE_SKIP_VERIFY). careful, bestie — this one skips TLS verification ⚠️
  • -p, --smtp.password — password of the SMTP server — env var: ($POP_SMTP_PASSWORD). secret secret 🤫
  • -P, --smtp.port — port of the SMTP server — env var: ($POP_SMTP_PORT). the door number 🚪
  • -U, --smtp.username — username of the SMTP server — env var: ($POP_SMTP_USERNAME). who dis 👤
  • -s, --subject — the email’s subject. make it clickable, make it cute 🎯
  • -t, --to — recipients. the lucky inboxes 💌
  • -u, --unsafe — whether to allow unsafe HTML in the email body; it also enables some extra markdown features (Experimental). experimental era 🧪
🧪 Experimental alert: -u, --unsafe is labeled Experimental in the original. That’s the whole caveat, bestie.

🦋 COMMANDS 🦋

auth

Authenticate with Resend via OAuth. get that auth sorted 🔐

OPTIONS ✨

  • --no-browser — simulate browser open failure (for testing). testing mode chaos 🧪

COMMANDS 🎀

  • revoke — revoke OAuth authentication with Resend. undo the auth moment 🚫

help [command]

Help about any command. when you need the manual for the manual 📖

install-skill

Install the Pop skill for AI agents. give the agents their little skill 🤖

OPTIONS ✨

  • -f, --force — overwrite existing skill files. no mercy for old files 💥

COMMANDS 🎀

  • claude — install the Pop skill for Claude Code. for Claude Code 🧠
  • codex — install the Pop skill for OpenAI Codex. for OpenAI Codex 🛠️
  • crush — install the Pop skill for Charm Crush. for Charm Crush 💘
  • cursor — install the Pop skill for Cursor (in the current directory). for Cursor, right here in the current directory 🖱️
  • pi — install the Pop skill for Pi (in the current directory). for Pi, also in the current directory 🥧

skill

Print a skill definition for AI agents. agent-ready output 🤖✨

© 2023 Charmbracelet, Inc.

Released under MIT License. legal bestie has entered the chat 📜

and that’s the whole page, bestie 💖 — footer energy: source/version pop, date 2026-10-22, manual POP(1). mwah 😽✨

📦 where this page comes from