bib

A CLI for managing a personal bibliography organized by topic.

Installation

chmod +x bib
export PATH="$PATH:/path/to/cli"

Commands

Create a new bibliography file

bib new --file <path>

Creates the file and any necessary parent directories. The filename (without extension) becomes the bibliography title.

Add an entry

bib add --file <path> --title "..." --type <type> --url <url> --comment "..."

If the file does not exist, it will be created with a warning. Duplicate titles within the same file are rejected.

Types: article, book, video, podcast, paper, course, other

Remove an entry

bib remove --file <path> --title "..."

Title matching is case-insensitive.

List entries

bib list --file <path>           # human-readable text
bib list --file <path> --json    # JSON array

Entry format

Entries are stored as structured blocks delimited by HTML comments (invisible when rendered):

<!-- entry -->
**Title:** Example Title
**Type:** article
**URL:** https://example.com

Comment text goes here.
<!-- /entry -->