bib-convert

Convert bibliography files between 5 supported formats:

• BibTeX - Classic LaTeX bibliography format
• BibLaTeX - Extended BibTeX with modern entry types (dataset, software, online)
• CSL JSON - Citation Style Language JSON (universal format)
• RIS - Reference Manager format (tag-based)
• EndNote XML - EndNote reference manager XML format

Usage

Convert bibliography to another format:

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/convert.ts input.bib --to=csl-json --output=output.json

Options

• --from=<format> - Source format (auto-detected if omitted)
• --to=<format> - Target format (required)
• --output=<file> - Output file (prints to stdout if omitted)
• --sort - Sort entries by ID
• --indent=<string> - Indentation for formatted output (default: 2 spaces)

Supported Formats

• bibtex - BibTeX (.bib)
• biblatex - BibLaTeX (.bib)
• csl-json - CSL JSON (.json)
• ris - RIS (.ris)
• endnote - EndNote XML (.xml)

Examples

Convert BibTeX to CSL JSON:

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/convert.ts references.bib --to=csl-json --output=references.json

Convert RIS to BibTeX with sorting:

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/convert.ts papers.ris --to=bibtex --output=papers.bib --sort

Auto-detect source format:

npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/convert.ts mystery.txt --to=bibtex

Conversion Architecture

The plugin uses a hub-and-spoke architecture with CSL JSON as the intermediate format:

BibTeX ←→ BibLaTeX ←→ CSL JSON ←→ RIS
                          ↕
                      EndNote XML

This ensures maximum fidelity for conversions between related formats while supporting all 5 formats.

Lossy Conversions

Some conversions may be lossy:

To BibTeX (lossy for modern types):

• dataset → @misc (BibTeX has no dataset type)
• software → @misc
• webpage → @misc
• patent → @misc

Warnings are generated for lossy conversions. Original type information is preserved in metadata for round-trip conversions.

To BibLaTeX (no loss):
All CSL JSON types map to BibLaTeX types without loss.

Output

The script outputs:

1. Conversion statistics (total, successful, warnings, failed)
2. Warnings for lossy conversions or parse errors
3. Converted bibliography (to file or stdout)

Notes

• Format auto-detection works for most files
• LaTeX special characters are automatically encoded/decoded (ä ↔ "{a})
• Name parsing handles particles (von, van, de) and suffixes (Jr., III)
• Date parsing supports multiple formats (ISO, natural language)