LEI(1)

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 diagnostics 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)