Citation Verification with Gemini File Search

Scan pandoc-flavored markdown drafts for citations, upload source PDFs to a Gemini File Search store, and verify each citation is grounded in its source. Produces a structured REVIEW-CITES.md report.

Prerequisites

• GOOGLE_API_KEY env var set (Google AI Studio; on this machine: export GOOGLE_API_KEY="$(cat $GEMINI_API_KEY_FILE)")
• Bun runtime
• rclone with a google-drive: remote configured (used to bypass Google Drive FUSE deadlocks)
• python3 with pymupdf4llm installed (used for PDF text extraction in passage grounding)
• readwise CLI installed and authenticated (for Readwise article export in source materialization)
• One or more .bib files with file fields mapping bibkeys to PDF paths (e.g., Paperpile's paperpile.bib)

Source Materialization

Before running cite-check, materialize all sources locally: