Mail

Create, edit, test, and send e-mails from the command line.

AI-assisted, human-approvednovem uses AI to review and keep our documentation up to date.

Install and authenticate the novem CLI before using these commands.

E-mails are selected with the -m flag. On its own, -m lists all of your e-mails; with a name it selects that e-mail for the operations described below.

# list all of your e-mails
novem -m

# select a single e-mail to operate on
novem -m monthly_update

Creating an e-mail

Add -C to create the e-mail if it doesn't already exist.

novem -m monthly_update -C

Recipients live under the e-mail's recipients folder. The --to, --cc and --bcc flags are shorthands for writing them. A recipient can be a novem user, a novem group (@user~group / +org~group), or a plain e-mail address. Separate multiple recipients with commas.

novem -m monthly_update --to "me,reader@example.com"
novem -m monthly_update --cc "@acme~analysts"

See recipients for the address rules and any sending restrictions on your account.

Setting the subject

novem -m monthly_update --subject "Monthly update — March"

Writing the content

The body is novem markdown written to the e-mail's content. Pipe a file in on stdin, or write it with -w.

# pipe a markdown file as the body
cat body.md | novem -m monthly_update -w content

# create, set subject + recipient, and pipe the body in one go
cat body.md | novem -m monthly_update -C \
  --subject "Monthly update" --to reader@example.com -w content

Sending

Send a test copy to your own registered address with -T, and send to the configured recipients with -S. Both render the e-mail before sending it.

# send a test to yourself
novem -m monthly_update -T

# send to the recipients
novem -m monthly_update -S

Note: free accounts can only send to their own registered, verified address.

Viewing

Read any path back with -r; the url path returns the shareable link.

novem -m monthly_update -r url

Like other novem resources, e-mails can be shared and tagged. Manage shares with -s (add with -C, remove with -D, a bare -s lists them) and tags with -t. See the plot page for the shared-flag patterns — they work identically for e-mails.

Deleting an e-mail

novem -m monthly_update -D

Plot

Python