Charm Pop

charm-pop

CLI and TUI tool for sending emails from the terminal. Requires either a RESEND_API_KEY or SMTP config.

Launch

pop          # open TUI

CLI Usage

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

pop --preview    # preview before sending

Body is read from stdin. --preview opens TUI for review before send.

Auth: Resend

export RESEND_API_KEY=re_xxxx

Get key at https://resend.com/api-keys. No custom domain: use onboarding@resend.dev as sender.

Auth: SMTP

export POP_SMTP_HOST=smtp.gmail.com
export POP_SMTP_PORT=587
export POP_SMTP_USERNAME=you@gmail.com
export POP_SMTP_PASSWORD=hunter2

Env Defaults

export POP_FROM=you@example.com
export POP_SIGNATURE="Sent with Pop!"

Saves typing --from every time.

Attachments

pop --attach file.pdf --attach image.png < body.txt

Multiple --attach flags supported.

Pipelines

# AI-written body via mods
pop <<< "$(mods -f 'Write a status update')" \
    --subject "Weekly update" --preview

# Pick sender with gum
pop --from $(gum choose "a@x.com" "b@x.com") \
    --to $(gum filter < contacts.txt)

# Generate and send invoice
invoice generate --item "Work" --rate 100 --output inv.pdf
pop --attach inv.pdf --body "Invoice attached."

Flags Reference

| Flag | Description | |------|-------------| | --from | Sender address | | --to | Recipient (repeatable) | | --subject | Email subject | | --body | Body text (or use stdin) | | --attach | File path to attach (repeatable) | | --preview | Open TUI preview before sending |

Install

brew install pop                      # macOS/Linux
go install github.com/charmbracelet/pop@latest

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: alxxpersonal
• Source: alxxpersonal/forge
• License: MIT

Install and usage instructions live in the source repository linked above.