calternal mail

Mail reader operations use stable provider-backed IDs and delegate all writes to the server (#396, DESIGN §45)

calternal mail <COMMAND>

calternal mail accounts

List connected Mail accounts

calternal mail accounts

calternal mail folders

List folders for one connected account

calternal mail folders <ACCOUNT_ID>

Argument	Description	Default
<ACCOUNT_ID>	Required.

calternal mail folder

Read a folder’s newest messages

calternal mail folder <ID> [--limit <LIMIT>]

Argument	Description	Default
<ID>	Required.
--limit <LIMIT>		50

calternal mail inbox

Read the newest messages grouped by thread

calternal mail inbox [--category <CATEGORY>] [--limit <LIMIT>]

Argument	Description	Default
--category <CATEGORY>	One of: people, newsletters, notifications, receipts, all.	people
--limit <LIMIT>		50

calternal mail thread

Read one conversation thread

calternal mail thread <ID> [--limit <LIMIT>]

Argument	Description	Default
<ID>	Required.
--limit <LIMIT>		50

calternal mail message

Read one message body and its headers

calternal mail message <ID>

Argument	Description	Default
<ID>	Required.

calternal mail attachments

List attachment metadata in one thread

calternal mail attachments <THREAD_ID>

Argument	Description	Default
<THREAD_ID>	Required.

calternal mail attachment

Save one attachment to a new local file

calternal mail attachment <MESSAGE_ID> <SECTION_ID> <OUTPUT>

Argument	Description	Default
<MESSAGE_ID>	Required.
<SECTION_ID>	Required.
<OUTPUT>	Required.

calternal mail oldest-unread

Find the oldest unread message in one thread

calternal mail oldest-unread <THREAD_ID>

Argument	Description	Default
<THREAD_ID>	Required.

calternal mail mark-read

Mark one message read, or unread with –unread

calternal mail mark-read <ID> [--unread]

Argument	Description	Default
<ID>	Required.
--unread		false

calternal mail read-marking

Read or change when message opens mark messages read

calternal mail read-marking [<VALUE>]

Argument	Description	Default
<VALUE>	One of: on-open, after-one-second, manually.

calternal mail category

Set the sender category for one message

calternal mail category <ID> <CATEGORY>

Argument	Description	Default
<ID>	Required.
<CATEGORY>	Required. One of: people, newsletters, notifications, receipts, all.

calternal mail remote-content

Read or change the one Load remote content preference (#726). Remote images load through the server for all senders, or for none

calternal mail remote-content [<LOAD>]

Argument	Description	Default
<LOAD>	One of: true, false.

Global options such as --json and --server apply to every command. See the CLI overview.