Lem/Docs

library

List or update Lem's manuscript-independent external-literature library.

Invocation#

Shell
lem-cli library [list|show|add|analyze] ...

Inputs and options#

  • A bare invocation is identical to library list.
  • show, add, and analyze each take one source: an arXiv id or arxiv.org URL, a DOI or doi.org URL, or the http(s) URL of the page that published the work. A page record can also be named by the host/path it is keyed on.
  • The selector is independent of the authored-manuscript registry.

Output and state#

The group reads ~/.lem/literature.json by default. LEM_LITERATURE_PATH selects another manifest and corresponding asset directory.

list and show are read-only. add writes metadata and reading assets; analyze writes supplied Markdown to an existing record.

A record is identified by its source's own identifier — paper_id, with source_kind beside it: arxiv, doi, or web. Two spellings of one work therefore reach one record.

Refusals#

  • An unknown leaf refuses with “unknown library subcommand: <name>”.
  • library help, -h, or --help prints the library usage and exits nonzero.