CommitCrafter 🎨

Craft your commit messages while you focus on coding. CommitCrafter analyzes your git diff and generates meaningful, conventional commit messages.

✨ What's Cool

• 🤖 Multiple AI Brains: Choose your favorite - GPT, Claude, Gemini, Mistral, or Ollama
• 🎯 Smart Selection: Pick from multiple suggestions for the perfect commit message
• 📋 Auto-Copy: Selected message goes straight to your clipboard
• 🎭 Conventional Commits: Proper formatting with emojis included
• 🔌 Just Works: Zero config needed - works with any git repo

🚀 Quick Start

# Install with pipx
pipx install commitcrafter

# Use it (in any git repository)
commitcraft         # Uses Claude by default
commitcraft -a gpt  # Or use GPT instead

🎮 Choose Your Model

commitcraft -a claude   # Anthropic's Claude
commitcraft -a gpt      # OpenAI's GPT
commitcraft -a gemini   # Google's Gemini
commitcraft -a mistral  # Mistral AI
commitcraft -a ollama   # Local Ollama

🔑 Setup

You'll need an API key for your chosen model. Set it as an environment variable:

# Pick the one you need:
export ANTHROPIC_API_KEY='your-key'
export OPENAI_API_KEY='your-key'
export GEMINI_API_KEY='your-key'
export MISTRAL_API_KEY='your-key'
export OLLAMA_API_KEY='your-key'

📦 Requirements

• Python 3.12+
• A git repository
• An API key for your chosen model

🤝 Contributing

Found a bug? Have an idea? PRs and issues are always welcome!

📝 License

MIT - Do whatever you want with it!

🔗 Useful Links

🛠️ Built With

• Pydantic-AI - Modern AI Agent Framework
• Typer - Beautiful CLI Builder
• Rich - Rich Terminal Output
• GitPython - Git Operations
• Pyperclip - Clipboard Management

🤖 AI Providers

• Anthropic Claude - Our Default Model
• OpenAI - GPT Integration
• Google Gemini - Google's LLM
• Mistral AI - Open Source Models
• Ollama - Local AI Runtime