nicholai-work-2026/src/utils/README.md

Utilities

This directory contains utility scripts for the project.

Git Commit Automation Script

git-commit.js

Automatically generates commit messages using OpenRouter AI (inception/mercury-coder) based on your staged changes. The script analyzes both the git diff and status to create meaningful commit messages, then allows you to review, edit, and approve before committing.

Prerequisites:

• OpenRouter API key (free to get started)
  • Sign up: openrouter.ai
  • Get your API key: openrouter.ai/keys
• Create a .env file in src/utils/ directory:

  # Copy the example file
  cp src/utils/.env.example src/utils/.env
  
  # Edit the file and add your API key
  OPENROUTER_API_KEY=your_actual_api_key_here
  

Usage:

# 1. Stage your changes
git add <files>

# 2. Run the commit script
pnpm commit

# 3. Review the AI-generated message
# 4. Choose to [A]ccept, [E]dit, or [C]ancel
# 5. Optionally push to remote

Options:

• --help, -h - Show help message

Troubleshooting:

• If you get ".env file not found" error, create src/utils/.env with your OpenRouter API key

Image Conversion Script

convert-to-avif.js

Converts images in the assets/ directory to AVIF format using ffmpeg. Original images are preserved, and .avif versions are created alongside them.

Prerequisites:

• ffmpeg must be installed on your system
  • Linux: sudo apt install ffmpeg sudo pacman -S ffmpeg
  • macOS: brew install ffmpeg
  • Windows: Download from ffmpeg.org

Usage via pnpm scripts:

# Show help and available options
pnpm run convert:avif

# Convert all supported formats (jpeg, png, webp, gif, bmp, tiff)
pnpm run convert:avif:all

# Convert only JPEG images
pnpm run convert:avif:jpeg

# Convert only PNG images
pnpm run convert:avif:png

# Convert with custom quality (0-100, default: 65)
node src/utils/convert-to-avif.js --jpeg --quality 80

# Convert multiple formats at once
node src/utils/convert-to-avif.js --jpeg --png

Options:

• --all - Convert all supported formats
• --jpeg - Convert JPEG/JPG files only
• --png - Convert PNG files only
• --webp - Convert WebP files only
• --gif - Convert GIF files only
• --bmp - Convert BMP files only
• --tiff - Convert TIFF files only
• --quality <n> - Set quality (0-100, default: 65)

Quality Guide:

• High (80+): Larger file sizes, excellent quality
• Medium (60-75): Balanced file size and quality (recommended)
• Low (40-55): Smaller files, good for web performance

Features:

• Preserves original images
• Skips files that already have AVIF versions
• Shows file size savings
• Progress indicators
• Error handling and reporting

Example output:

🎨 Converting 3 image(s) to AVIF format
📁 Source: /path/to/assets
⚙️  Quality: 65

🔄 [1/3] Converting blog-placeholder-1.jpg...
   ✅ Created blog-placeholder-1.avif (45.2KB, 67.3% smaller)