bib-filter

Bibliography Filter

Produce and validate a cited-only bibliography, then replace the manuscript's canonical .bib only after explicit approval. In an Overleaf-linked project, the resolved Overleaf bibliography is canonical; a wrapper-local copy is not a second authority.

When to Use

• Before submission — strip unused references from the bibliography
• When a shared .bib (e.g., Paperpile/Paperpile export) contains hundreds of entries but the paper cites a subset
• To reduce .bib file size for Overleaf or arXiv upload
• As a cleanup step after major revision (removed sections may leave orphan citations)

Process

Step 1: Locate files

If given a directory, resolve the actual manuscript source first:

• For paper-<arm>/paper, run realpath/readlink and inspect the resolved Overleaf target before declaring a bibliography missing.
• Read \bibliography{...} or \addbibresource{...} from the canonical driver and resolve the referenced .bib relative to that source tree.
• Do not select a project-root export, backup, or stale wrapper copy merely because it has the same filename.

Then find the main .tex and .bib files:

• .tex: Glob for *.tex in the directory (and paper/ subdirectory if it exists). The main file is the one containing \begin{document}.
• .bib: Look for \bibliography{...} or \addbibresource{...} in the main .tex to find the bib filename. Fall back to globbing *.bib.

If given a specific .tex file, derive the .bib from it.

Step 2: Extract all citation keys from .tex

Scan all .tex files in the project (main + any \input{}/\include{} files) for citation commands:

\cite{key1,key2}
\citep{key1,key2}
\citet{key1}
\citealt{key1}
\citealp{key1}
\citeauthor{key1}
\citeyear{key1}
\citetext{key1}
\parencite{key1,key2}
\textcite{key1}
\autocite{key1}
\footcite{key1}
\fullcite{key1}
\nocite{key1}

Handle:

• Multiple keys in one command: \cite{key1,key2,key3} → extract all three
• Whitespace around commas: \cite{key1, key2} → trim
• Optional arguments: \cite[p.~5]{key1} or \citep[see][]{key1} → extract key1
• \nocite{*} → special case: means "include everything", so filtered.bib = full .bib (warn and stop)