Tutorial 3: Library workflows

This tutorial covers adsfolio library commands for listing, reading, and syncing a library BibTeX file.

0) Start with `--help`

First, inspect the library command group and its subcommands:

adsfolio library --help
adsfolio library list --help
adsfolio library get --help
adsfolio library watch --help

Key library options:

Option	Meaning	When to use
`library list --rows`	Number of libraries to fetch	Accounts with many libraries
`library list --json`	JSON output for list result	Scripted selection by id/name
`library get --raw`	Return bibcodes exactly as stored	Debugging library state or ADS normalization differences
`library get --bibtex --output`	Export one library directly to a `.bib` file	One-shot sync for LaTeX projects
`library watch --num-iter`	Polling iteration count (`0` = infinite)	Long-running background sync
`library watch --interval`	Seconds between checks	Tune API usage vs freshness
`library watch --info-interval`	Status-print cadence	Reduce noisy logs in long sessions
`library watch --additional`	Append local BibTeX file to watched export	Merge ADS refs + local/manual entries

adsfolio library list

For JSON output:

adsfolio library list --rows 50 --json

adsfolio library get <library_id>

To return the raw bibcodes exactly as stored:

adsfolio library get <library_id> --raw

adsfolio library get <library_id> --bibtex --output references.bib

adsfolio library watch <library_id> \
  --output references.bib \
  --num-iter 0 \
  --interval 10

Notes:

--num-iter 0 means run indefinitely.
To stop the watch, press Ctrl+C.
The watcher writes the output file when it starts and again each time the library changes.
Point --output at a folder that your LaTeX project reads, for example a folder that you sync with Overleaf.

adsfolio library watch <library_id> \
  --output references.bib \
  --journal full \
  --additional local_notes.bib \
  --num-iter 0

adsfolio library watch <library_id> \
  --info-interval 10 \
  --interval 5 \
  --num-iter 200