mosaic similar

Finds papers related to one paper, given its DOI or arXiv ID. No query needed: the related works come from OpenAlex and, when a Semantic Scholar key is set, from Semantic Scholar's recommendations.

Usage

mosaic similar 10.1063/1.4972269                           # related to one DOI
mosaic similar arxiv:2304.06563 --max 20 --sort citations  # an arXiv paper, most cited first
mosaic similar 10.1063/1.4972269 --oa-only --download      # fetch the open ones
mosaic similar 10.1063/1.4972269 -o related.bib            # save as BibTeX
mosaic similar 10.1063/1.4972269 --json                    # JSON, with the seed title

Behaviour

IDENTIFIER is a bare DOI, doi:10.xxx, or arxiv:NNNN.NNNNN (either case). OpenAlex related_works is always queried and needs no key; Semantic Scholar recommendations are added when semantic_scholar.api_key is set (mosaic config --ss-key KEY). Results are merged by the same rule as search and saved in the cache.

The title of the seed paper is printed above the table, and is the seed field of --json output. Exit code 1 if the paper is not found.

See also: tutorial 7, similar papers, recipes.

Options

mosaic similar [OPTIONS] IDENTIFIER

Argument	Value	Description
IDENTIFIER	TEXT	DOI or arXiv ID of the seed paper (e.g. 10.48550/arXiv.1706.03762 or arxiv:1706.03762)

Option	Value	Default	Description
--max, -n	INTEGER	10	Max similar papers to return
--download, -d			Download available PDFs
--oa-only			Show only open-access papers
--pdf-only			Show only papers with a downloadable PDF
--sort	TEXT		Sort results: "citations" (most cited first), "year" (newest first), or "relevance" (most relevant first)
--output, -o	PATH		Save results to file (.md, .markdown, .csv, .json, .bib, .ris); repeatable
--download-dir	TEXT		Override PDF download directory for this run
--zotero			Export results to Zotero
--zotero-collection	TEXT		Zotero collection name (created if missing)
--zotero-local			Force Zotero local API even when an API key is configured
--obsidian			Export results as notes to an Obsidian vault
--obsidian-folder	TEXT		Override Obsidian vault subfolder for this run
--json			Emit structured JSON to stdout instead of a table (useful for scripting and AI agents)