NAME

lei - an overview of lei mail synchronization

DESCRIPTION

lei(1) provides several plumbing-level commands to synchronize mail and keywords (flags) between lei/store and existing IMAP and Maildir stores. Nothing documented in this manpage is required for day-to-day use against externals.

Mail and keyword synchronization is currently a clunky process. Future work will be done to improve it and add IMAP IDLE support.

TYPICAL WORKFLOW

# import mail from a user's IMAP inbox and give it the "inbox" label:
lei import +L:inbox imaps://user@example.com/INBOX
# dump "inbox" labeled files from the past week to a Maildir
lei q L:inbox rt:last.week.. -o /tmp/results
# open /tmp/results in your favorite mail agent.  If inotify or kevent
# works, keyword changes (e.g. marking messages as `seen') are
# synchronized automatically.
# If the inotify queue overflows, or if lei-daemon crashes,
# "lei index" will tell lei about keyword changes:
lei index /tmp/results
# Optional: cleanup stale entries from mail_sync.sqlite3
lei refresh-mail-sync /tmp/results
# to export keyword changes back to IMAP
lei export-kw imaps://user@example.com/INBOX