ivabus/pop

mirror of https://github.com/ivabus/pop synced 2024-09-20 00:20:48 +03:00

Go to file

Ayman Bagabas 318f26ac85 fix(ci): add dockerfile		2023-07-13 11:33:55 -04:00
.github	feat(ci): add CD/CI pipelines	2023-07-13 11:09:32 -04:00
examples	fix: update demo.tape and gif	2023-07-11 14:14:33 -04:00
.gitignore	fix(ci): use goreleaser-full meta config	2023-07-13 11:18:48 -04:00
.golangci-soft.yml	feat(ci): add CD/CI pipelines	2023-07-13 11:09:32 -04:00
.golangci.yml	feat(ci): add CD/CI pipelines	2023-07-13 11:09:32 -04:00
.goreleaser.yml	fix(ci): use goreleaser-full meta config	2023-07-13 11:18:48 -04:00
attachments.go	feat: email tui	2023-06-13 23:31:19 -04:00
Dockerfile	fix(ci): add dockerfile	2023-07-13 11:33:55 -04:00
email.go	fix: seed attachments from command line	2023-06-27 14:34:28 -04:00
go.mod	feat: add man page	2023-07-13 11:05:27 -04:00
go.sum	fix(ci): use goreleaser-full meta config	2023-07-13 11:18:48 -04:00
go.work	feat: email tui	2023-06-13 23:31:19 -04:00
go.work.sum	chore(deps): bump bubbles	2023-07-13 11:00:46 -04:00
keymap.go	fix: enable filepicker keymap only when selecting file.	2023-06-22 10:48:30 -04:00
LICENSE	chore: add LICENSE	2023-06-22 16:17:55 -04:00
main.go	feat: add man page	2023-07-13 11:05:27 -04:00
model.go	fix: placeholder style	2023-07-11 12:55:58 -04:00
README.md	fix: update demo.tape and gif	2023-07-11 14:14:33 -04:00
style.go	fix: separate email sent to links	2023-06-20 10:21:01 -04:00

README.md

Pop

Send emails from your terminal.

Text-based User Interface

Launch the TUI

pop

Command Line Interface

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

To use pop, you will need a RESEND_API_KEY.

You can grab one from: https://resend.com/api-keys.

Environment

To avoid typing your From: email address, you can also set the POP_FROM environment to pre-fill the field anytime you launch pop.

export RESEND_API_KEY=$(pass RESEND_API_KEY)
export POP_FROM=pop@charm.sh
export POP_SIGNATURE="Sent with [Pop](https://github.com/charmbracelet/pop)!"

Installation

Use a package manager:

# macOS
brew install pop

# Arch
yay -S pop

# Nix
nix-env -iA nixpkgs.pop

Install with Go:

go install github.com/charmbracelet/pop@latest

Or download a binary from the releases.

Examples

Pop can be combined with other tools to create powerful email pipelines, such as:

Mods

Use mods with pop to write an email body with AI:

Note

: Use the --preview flag to preview the email and make changes before sending.

pop <<< '$(mods -f "Explain why CLIs are awesome")' \
    --subject "The command line is the best" \
    --preview

Generate email with mods and send email with pop.

charmbracelet/mods

Gum

Use gum with pop to choose an email to send to and from:

pop --from $(gum choose "vt52@charm.sh" "vt78@charm.sh" "vt100@charm.sh")
    --to $(gum filter < contacts.txt)

Select contact information with gum and send email with pop.

charmbracelet/gum

Invoice

Use invoice with pop to generate and send invoices entirely from the command line.

FILENAME=invoice.pdf
invoice generate --item "Rubber Ducky" --rate 25 --quantity 2 --output $FILENAME
pop --attach $FILENAME --body "See attached invoice."