Read and organize
briskmail search
BuiltSearch mail and get back metadata rows, never bodies.
Taught in lesson 2, Triage your inbox with an agent.
Usage
briskmail search <query> [--json]Returns only id, thread id, sender, subject, date, labels and unread state for each message. No snippet or body.
Runs only while Let apps read and organize my mail is on. With it off, the command exits 2 and names the switch.
Arguments and flags
<query>required- A search in Gmail's syntax.
--json- Print one JSON document.
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
| Code | Meaning |
|---|---|
| 0 | Done. Prints the rows. |
| 2 | Not allowed: macOS refused Automation for the app you ran it from (-1743), or this command's switch is off. The message names the switch. |
| 3 | Briskmail reported an error, printed on stderr. |
| 64 | Bad usage. |
Examples
briskmail search "from:dana@example.com" --json