honest-scholar --version to print the installed version. This page is generated from the Typer app on every build, so it always matches the released CLI.
honest-scholar doctor
Report the local environment: Python, uv and rclone.
Prints a short diagnostic report. Missing optional tools (uv,
rclone) are reported, not treated as failures. Always exits 0.
honest-scholar literature
Citation-graph and metadata tools.
honest-scholar literature resolve
Resolve an identifier (DOI, arXiv id, OpenAlex/S2 id) to a canonical work.
honest-scholar literature cites
List works that cite the given work (JSON array).
honest-scholar literature refs
List the backward references (OpenAlex ids) of the given work.
honest-scholar literature enrich
Enrich one or more works with their metadata bundle (JSON array).
honest-scholar literature neighbors
List co-citation / bibliographic-coupling neighbours of the given work.
honest-scholar dataset
Dataset manifest, retrieval and mirroring.
honest-scholar dataset validate
Validate a datasets.yml manifest (the register/audit gate).
Prints a JSON report {ok, errors, warnings} and exits non-zero on any
hard error.
honest-scholar dataset ingest
Ingest a published Croissant JSON-LD file to bootstrap a draft entry.
Prints the draft registry entry as JSON, with the human-owned fields it could
not fill listed under _needs_human (the caller confirms them on register).
honest-scholar dataset emit
Emit a Croissant JSON-LD document for a manifest entry (or all entries).
honest-scholar dataset fetch
Fetch a registered dataset through the resolution chain (pooch/rclone).
honest-scholar dataset verify
Verify on-disk bytes against the manifest SHA-256 (offline).
honest-scholar dataset mirror
Populate/refresh the private rclone mirror for a dataset.
honest-scholar dataset audit
Audit fixity, mirror presence and manifest completeness.
honest-scholar defend
Defensibility record helpers.
honest-scholar defend record
Record a defend examination: patch understanding + append the log.
Writes status.understanding into the artifact frontmatter and appends the
outcome to the accountability log. Records observed facts only — never a
verdict, score, or answer key.
honest-scholar backlog
Exploration backlog management.
honest-scholar backlog park
Park a raw one-line idea as a parked backlog row.
honest-scholar backlog add
Add a candidate row (realizes the generate verb).
honest-scholar backlog list
List backlog rows as JSON (read-only), optionally filtered by status.
honest-scholar backlog rank
Score a row and set it ranked (advises; never selects).
honest-scholar backlog promote
Mark a ranked row promoted (an explicit human pick).
Flips the row’s status and saves the backlog. Scaffolding the next-stage
artifact is a follow-up step (scaffold_hypothesis / scaffold_paper).
honest-scholar backlog drop
Retire a row as dropped with a recorded reason (never deletes it).
honest-scholar keys
Store, list and check API keys & credentials (ADR-0029).
honest-scholar keys set
Store a key. The value comes from stdin or a hidden prompt, never argv.
Piping a JSON object ({"NAME": "value", ...}) sets many at once. Unknown
names warn but are still stored. No value is ever echoed.