gitpdf

Export your git commit history to a beautifully formatted PDF.

Usage

Run inside any git repository:

# Interactive mode (opens a wizard UI)
npx gitpdf

# CLI mode (skip the UI)
npx gitpdf --author "John" --from 2024-01-01 --to 2024-12-31 --theme dark --font jetbrains-mono --layout landscape -o report.pdf

CLI Options

| Option | Description | Default | |--------|-------------|---------| | -a, --author <name> | Filter commits by author | All authors | | --from <date> | Start date (YYYY-MM-DD) | All time | | --to <date> | End date (YYYY-MM-DD) | Now | | -l, --layout <type> | portrait or landscape | portrait | | -t, --theme <theme> | light or dark | light | | -f, --font <font> | figtree, jetbrains-mono, or helvetica | figtree | | --no-date | Hide commit dates | | | --no-description | Hide commit body/description | | | --no-show-author | Hide author column | | | --no-hash | Hide commit hash column | | | --no-badges | Disable conventional commit badges | | | -o, --output <path> | Output file path | commits.pdf |

Features

• Interactive wizard UI powered by Ink
• Conventional commit badges (feat, fix, chore, docs, etc.)
• Dark and light themes
• Font choices: Figtree, JetBrains Mono, Helvetica
• Portrait or landscape orientation
• Configurable columns (hash, date, author, description)
• Date range filtering
• Author filtering

Development

bun install
bun run dev