LEI-TAG(1)

📦
version 2.1.0 · 5 versions
, in arch rolling, nixos 26.05, nixpkgs unstable

🎀 NAME 🎀

Okay so welcome to lei-tag(1) from the public-inbox user manual, bestie! This one is literally about setting or unsetting metadata on messages. Slay.

🦋 SYNOPSIS 🦋

No cap, here's the shape of it:

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

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

✨ DESCRIPTION ✨

So lei tag sets or unsets volatile metadata on messages — and in JMAP terms, "volatile metadata" includes "mailboxes" (which are analogous to a folder or label) and a restricted set of "keywords". The supported keywords are the combination of system keywords (seen, answered, flagged, and draft) — those map to Maildir flags and mbox Status/X-Status headers — plus the reserved keywords (forwarded, phishing, junk, and notjunk). Iconic.

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

💅 OPTIONS 💅

  • -F MAIL_FORMAT, --in-format=MAIL_FORMAT — picks the message input format: eml, mboxrd, mboxcl2, mboxcl, or mboxo. Default: eml. So if you don't say anything, it's giving eml energy. Default: eml is the vibe.
  • -q, --quiet — suppresses feedback messages. Lowkey silence, highkey useful. 🤫

🏷️ 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 — yes bestie, plural labels are allowed. 💖

🔑 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. Obsessed with the clarity.

📬 CONTACT 📬

Feedback welcome via plain-text mail to <mailto:meta@public-inbox.org> — they literally say plain-text, so keep it cute and simple. 🫶

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

Copyright 2021 all contributors <mailto:meta@public-inbox.org>.

License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>. Respect the license, bestie. 👑

👀 SEE ALSO 👀

okay that's a wrap on LEI-TAG(1) from public-inbox.git, dated 1993-10-02 — mwah 💋✨

📦 where this page comes from