bib-filter

Filter bibliography entries by various criteria.

Usage

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/filter.ts input.bib [criteria] --output=filtered.bib

Filter Criteria

• •--id=<string> - Filter by entry ID (exact match)
• •--author=<string> - Filter by author name (substring match)
• •--year=<number> - Filter by publication year
• •--type=<string> - Filter by entry type (article, book, etc.)
• •--keyword=<string> - Filter by keyword (substring match)

Multiple criteria are combined with AND logic.

Options

• •--output=<file> - Output file (prints to stdout if omitted)
• •--sort - Sort filtered results

Examples

Find all papers by Smith:

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/filter.ts refs.bib --author=Smith

Find papers from 2024:

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/filter.ts refs.bib --year=2024 --output=2024-papers.bib

Find articles about machine learning:

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/filter.ts refs.bib --keyword="machine learning"

Filter by type:

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/filter.ts refs.bib --type=article-journal

Combine multiple criteria:

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/filter.ts refs.bib --author=Smith --year=2024 --type=article

Output

Total entries: 150
Filtered entries: 12
[Filtered bibliography output...]

Matching Behavior

• •ID: Exact match
• •Author: Case-insensitive substring match (checks all authors)
• •Year: Exact year match
• •Type: Exact type match (e.g., "article-journal")
• •Keyword: Case-insensitive substring match

Use Cases

Extract subset for a specific paper:

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/filter.ts main.bib --keyword="neural networks" --output=nn-refs.bib

Find all books:

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/filter.ts refs.bib --type=book

Get recent publications:

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/filter.ts refs.bib --year=2024

Notes

• •Format is auto-detected
• •Output uses same format as input
• •Empty results return empty bibliography file
• •Can be combined with --sort for ordered output