lei-tag(1)

lei-tag1

Set/unset metadata on messages

Usage

lei tag [OPTIONS] FILE [FILE ...] METADATA [METADATA ...]

lei {tag [OPTIONS] (- | --stdin) METADATA [METADATA ...]}

Overview

Set or unset volatile metadata on messages. In JMAP terms, "volatile metadata" includes "mailboxes" (analogous to a folder or label) and a restricted set of "keywords". This supported keywords are the combination of system keywords (seen, answered, flagged, and draft), which map to Maildir flags and mbox Status/X-Status headers, as well as reserved keywords (forwarded, phishing, junk, and notjunk).

To add a label or keyword, prefix it with "+L:" and "+kw:", respectively. To remove a label or keyword, use "-L:" or "-kw:". For example, "+kw:flagged" would set the "flagged" keyword for the specified messages, and "-L:INBOX" would remove the "INBOX" label.

Options

-F MAIL_FORMAT
--in-format=MAIL_FORMAT

Message input format: "eml", "mboxrd", "mboxcl2", "mboxcl", or "mboxo".

Default: "eml"

-q
--quiet

Suppress feedback messages.

Labels

Labels are user-defined values analogous to IMAP/JMAP mailbox names. They must only contain lowercase characters, digits, and a limited amount of punctuation (e.g. ".", "-", "@").

Messages may have multiple labels.

Keywords

Keywords are "flags" in Maildir and IMAP terminology. Common keywords include: "seen", "answered", "flagged", and "draft", though "forwarded", "phishing", "junk", and "notjunk" are also supported.

When writing to various mboxes, the common keywords will be mapped to the "Status" and "X-Status" headers.

Messages may have multiple keywords.

Contact

Feedback welcome via plain-text mail to <mailto:[email protected]>

The mail archives are hosted at <https://public-inbox.org/meta/> and <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>

Releases

3 releases since Debian 12 (Bookworm); the text changed 1 time.

  1. 12–13
  2. Arch

From lei 2.1.0-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.