Skip to content
Briskmail
See availability

Send without asking

briskmail send

Built

Send without you, to known recipients only, through Undo Send. Anything else becomes a draft.

Taught in lesson 3, Permissions and safety.

Usage

briskmail send --to ADDRESSES [--cc A] [--bcc A] [--subject S] [--body B | --body-file F]

Requires the off-by-default auto-send switch and Touch ID grant. Every recipient must be in the thread, Contacts or past sent mail. Briskmail holds eligible messages in Undo Send before delivery.

Runs only while Let apps send without asking is on. With it off, the command exits 2 and names the switch.

Arguments and flags

--to ADDRESSESrequired
Recipients, comma-separated. At least one is required.
--cc ADDRESSES
Cc recipients, comma-separated.
--bcc ADDRESSES
Bcc recipients, comma-separated.
--subject TEXT
The subject.
--body TEXT
Plain text body. Not with --body-file.
--body-file PATH
Read the body from a file, or stdin with -. Not with --body.

Global flags

--account ID
An account id from accounts.json. Leave it out to use the first account. Accepted before or after the command.
--dev
Send the command to the dev build (com.valleyedgeconsulting.edgemail.dev) instead of Briskmail. Only useful when working on Briskmail itself.

Exit codes

CodeMeaning
0Done. Prints sent, held-as-draft or rate-limited.
2Not allowed: macOS refused Automation for the app you ran it from (-1743), or this command's switch is off. The message names the switch.
3Briskmail reported an error, printed on stderr.
64Bad usage.

Examples

briskmail send --to new@unknown.example --subject Hello --body "Can we talk?"
held-as-draft

An address the account has never written to: saved as a draft, nothing sent.

briskmail send --to known@example.com --subject Update --body-file message.txt
sent

Briskmail holds the message in Undo Send before delivery.