NAME

       lei - local email interface

SYNOPSIS

       lei [OPTIONS] COMMAND

DESCRIPTION

       lei is a command-line tool for importing and searching email, regardless of whether it is
       from a personal mailbox or a public-inbox.  lei supports a local, writable store built on
       top of public-inbox-v2-format(5) and public-inbox-extindex(1).  lei-q(1) provides an
       interface for querying messages across the lei store and read-only local and remote
       "externals" (inboxes and external indices).

       Warning: lei is still in its early stages and may destroy mail.  Be sure to have backups
       of destinations lei writes to.

       Available in public-inbox 1.7.0+.

OPTIONS

       -c NAME=VALUE
           Override configuration "NAME" to "VALUE".

       -C DIR
           Change current working directory to the specified directory before running the
           command.  This option can be given before or after "COMMAND" and is accepted by all
           lei subcommands except lei-daemon-kill(1).

COMMANDS

       Subcommands for initializing and managing local, writable storage:

       •   lei-init(1)

       •   lei-import(1)

       •   lei-tag(1)

       The following subcommands can be used to manage and inspect external locations:

       •   lei-add-external(1)

       •   lei-forget-external(1)

       •   lei-ls-external(1)

       Subcommands related to searching and inspecting messages from the lei store and configured
       externals are

       •   lei-blob(1)

       •   lei-config(1)

       •   lei-edit-search(1)

       •   lei-forget-search(1)

       •   lei-lcat(1)

       •   lei-ls-search(1)

       •   lei-p2q(1)

       •   lei-q(1)

       •   lei-rediff(1)

       •   lei-up(1)

       Other subcommands include

       •   lei-add-watch(1)

       •   lei-config(1)

       •   lei-convert(1)

       •   lei-daemon-kill(1)

       •   lei-daemon-pid(1)

       •   lei-forget-mail-sync(1)

       •   lei-mail-diff(1)

       •   lei-inspect(1)

       •   lei-ls-label(1)

       •   lei-ls-mail-source(1)

       •   lei-ls-mail-sync(1)

       •   lei-ls-watch(1)

       •   lei-rm-watch(1)

FILES

       By default storage is located at "$XDG_DATA_HOME/lei/store".  The configuration for lei
       resides at "$XDG_CONFIG_HOME/lei/config".

ERRORS

       Errors and dianostics for interactive commands are reported to stderr.  Some errors for
       background tasks are emitted via syslog(3) as lei-daemon(8) for the top-level daemon, and
       "lei/store" for the lei-store-format(5) worker.

CONTACT

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

COPYRIGHT

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

       License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>

SEE ALSO

       lei-overview(7), lei-daemon(8)