Generate clean, consistent PRs from commits - powered by AI and your git history.

📖 Full Documentation

Features ✨

• Multi-provider AI: Groq, Cerebras, and OpenAI-compatible APIs
• Smart commit filtering: Excludes noise commits
• PR template support: Use your existing templates
• GitHub CLI integration: Generate gh pr create commands
• Multilingual: 12+ languages supported
• Custom context: Guide AI generation style

Installation 📦

npm install -g lazypr

Requires Node.js >= 20. See installation guide →

Quick start ⚡

1. Set your API key:

   lazypr config set GROQ_API_KEY=<your-key>

2. Generate a PR:

   lazypr              # compares against main
   lzp                 # short alias
   lazypr develop      # compare against different branch

Complete quick start guide → | Usage examples →

Configuration ⚙️

lazypr config set KEY=VALUE    # Set configuration
lazypr config get KEY          # Get configuration

Common settings:

• PROVIDER - AI provider (groq, cerebras, or openai)
• LOCALE - Output language (en, es, pt, fr, etc.)
• MODEL - AI model to use
• FILTER_COMMITS - Smart commit filtering
• CONTEXT - Custom guidance for AI generation
• OPENAI_BASE_URL - Custom endpoint for OpenAI-compatible APIs

View all settings → | Configuration examples →

Advanced Features

• Smart Commit Filtering - Automatically excludes merge commits, dependency updates, and formatting changes
• PR Templates - Use your existing .github templates
• GitHub CLI Integration - Generate gh pr create commands
• Multilingual Support - 12+ languages available
• Context Guidance - Customize AI generation style
• GitHub Actions - Automate PR generation in CI/CD
• OpenAI-Compatible APIs - Use local providers (Ollama, LM Studio) or third-party services

CLI Reference

lazypr [target] [options]

Options:
  -t, --template [name]      Use a PR template
  -l, --locale <language>    Output language
  -c, --context <text>       Custom AI guidance
  --gh                       Generate gh pr create command
  --no-filter                Disable smart filtering
  -u, --usage                Show token usage
  -h, --help                 Display help

View complete CLI reference →

Development

bun install      # Install dependencies
bun test         # Run tests
bun run build    # Build for production

Uses Bun for development, Node.js >= 20 for runtime.

Contributing 🤝

Issues and PRs are welcome. Open one on the repository’s Issues page.

License 📄

MIT © Raul Carini. See the LICENSE file for details.