Fob
Browse the docs

Emails

Generated from --help output of fob-email 0.2.0. Every command also accepts --help and --version.

emails#

emails list#

fob-email emails list

List emails in a folder (newest first)

Options:
      --account  Configured account name                                [string]
      --folder   Mailbox folder                      [string] [default: "INBOX"]
      --unseen   Only unread messages                                  [boolean]
      --limit    Max messages                             [number] [default: 50]
      --fields   Columns (comma-separated)                              [string]
      --cached   Read the local mirror (see `sync run`)                [boolean]
      --json     Output raw JSON                                       [boolean]
fob-email emails search [query]

Search a folder (IMAP SEARCH — keyword/header/date, not semantic)

Positionals:
  query  Text to match (headers + body)                                 [string]

Options:
      --account  Configured account name                                [string]
      --folder   Mailbox folder                      [string] [default: "INBOX"]
      --from     Match sender                                           [string]
      --subject  Match subject                                          [string]
      --since    On/after date (YYYY-MM-DD)                             [string]
      --limit    Max messages                             [number] [default: 50]
      --fields   Columns (comma-separated)                              [string]
      --cached   Read the local mirror (no body search)                [boolean]
      --json     Output raw JSON                                       [boolean]

emails show#

fob-email emails show <id>

Show one full email by id

Positionals:
  id  Message id (per-folder UID)                            [number] [required]

Options:
      --account  Configured account name                                [string]
      --folder   Mailbox folder                      [string] [default: "INBOX"]
      --json     Output raw JSON                                       [boolean]

emails download#

fob-email emails download <id>

Save a message's attachments to disk

Positionals:
  id  Message id (per-folder UID)                            [number] [required]

Options:
      --account  Configured account name                                [string]
      --folder   Mailbox folder                      [string] [default: "INBOX"]
      --json     Output raw JSON                                       [boolean]
  -o, --output   Output directory                                       [string]

emails mark#

fob-email emails mark <id>

Mark a message read or unread

Positionals:
  id  Message id (per-folder UID)                            [number] [required]

Options:
      --account  Configured account name                                [string]
      --folder   Mailbox folder                      [string] [default: "INBOX"]
      --json     Output raw JSON                                       [boolean]
      --read     Mark as read                                          [boolean]
      --unread   Mark as unread                                        [boolean]

emails move#

fob-email emails move <id>

Move a message to another folder

Positionals:
  id  Message id (per-folder UID)                            [number] [required]

Options:
      --account  Configured account name                                [string]
      --folder   Mailbox folder                      [string] [default: "INBOX"]
      --json     Output raw JSON                                       [boolean]
      --to       Destination folder                          [string] [required]

emails delete#

fob-email emails delete <id>

Permanently delete a message

Positionals:
  id  Message id (per-folder UID)                            [number] [required]

Options:
      --account  Configured account name                                [string]
      --folder   Mailbox folder                      [string] [default: "INBOX"]
      --json     Output raw JSON                                       [boolean]
  -y, --yes      Confirm deletion                                      [boolean]

emails send#

fob-email emails send

Send an email (SMTP)

Options:
      --account    Configured account name                              [string]
      --to         Recipient (repeatable)                     [array] [required]
      --cc         Cc (repeatable)                                       [array]
      --bcc        Bcc (repeatable)                                      [array]
      --subject    Subject                                              [string]
      --body       Body text                                            [string]
      --body-file  Read body from a file                                [string]
      --attach     Attach a file (repeatable)                            [array]
      --json       Output raw JSON                                     [boolean]

emails filter#

fob-email emails filter

Filter an envelopes JSON array from stdin (pure, no connection)

Options:
      --from            Substring match on From                         [string]
      --to              Substring match on To                           [string]
      --subject         Substring match on Subject                      [string]
      --has-attachment  Only messages with an attachment               [boolean]
      --seen            Only seen messages                             [boolean]
      --unseen          Only unseen messages                           [boolean]