Your company here — click to reach over 10,000 unique daily visitors

lei-tag - Man Page

set/unset metadata on messages


lei tag [Options] FILE [FILE...] METADATA [METADATA...]

lei tag [Options] (-|--stdin) METADATA [METADATA...]


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.



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

Default: eml


Suppress feedback messages.


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 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.


Feedback welcome via plain-text mail to <mailto:meta@public-inbox.org>

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

See Also


Referenced By

lei(1), lei-export-kw(1), lei-import(1), lei-mail-formats(5), lei-q(1).

1993-10-02 public-inbox.git public-inbox user manual