Claude Auto-Commit

Claude Auto-Commit is an open-source tool that automatically generates intelligent Git commit messages by analyzing your code changes using Claude Code SDK. It integrates seamlessly into your development workflow with enhanced performance, reliability, and modern JavaScript architecture.

🌟 Transform Your Commit History

⚠️ Important Notes:

• Requires Claude Pro/Max subscription and Claude CLI authentication
• No API key needed - uses Claude Code SDK with OAuth authentication
• Run claude login first if not already authenticated
• By default, this tool will automatically stage all changes and commit
• Use --push flag to enable auto-push to remote repository
• Use --dry-run flag to preview commit messages without committing

🚀 Quick Start

Installation Options

Method 1: NPX execution (recommended, no installation needed)

npx claude-auto-commit

Method 2: NPM global installation

npm install -g claude-auto-commit

Method 3: Script installation

curl -fsSL https://raw.githubusercontent.com/0xkaz/claude-auto-commit/main/scripts/install.sh | bash

Method 4: One-time script execution

curl -fsSL https://raw.githubusercontent.com/0xkaz/claude-auto-commit/main/scripts/run-once.sh | bash

Basic Usage

# Analyze changes and generate commit message
npx claude-auto-commit
Japanese with emojis and conventional commits
npx claude-auto-commit -l ja -e -c
Custom commit type with auto-push
npx claude-auto-commit -t feat --push

Authentication Setup

Claude Auto-Commit uses Claude Code SDK which requires Claude Pro or Max subscription:

# First-time setup: Login to Claude CLI
claude login
Choose option: "2. Claude app (requires Max subscription)"
This opens your browser for OAuth authentication
No API key needed - authentication is handled automatically

After initial login, your authentication is saved and claude-auto-commit will work seamlessly.

✨ Features

• 🧠 AI Analysis: Leverages Claude Code SDK for intelligent code change understanding
• 🌍 Multi-language: Interface available in English and Japanese
• 📝 Conventional Commits: Optional support for conventional commit format
• 😊 Emoji Support: Add contextual emojis to commit messages
• 🔍 Dry Run Mode: Preview commit messages without making actual commits
• 📝 Template System: Save and reuse common commit message patterns
• ⚙️ Configuration: JSON-based configuration file support
• 🔄 Retry Mechanism: Enhanced error handling with exponential backoff
• ⚡ Performance: Parallel processing and intelligent caching
• 🚀 Auto-push: Optional automatic push to remote repository
• 📊 Verbose Logging: Detailed execution metrics and statistics
• 🛠️ Configurable: Extensive customization through CLI options and config files
• 📦 Modern Architecture: Node.js ES modules with TypeScript support

📖 Documentation

• English Documentation
• 日本語ドキュメント
• 中文文档

Complete documentation available in this repository.

📋 Requirements

System Requirements

• Node.js 22.0.0 or later
• Git repository
• ANTHROPIC_API_KEY environment variable

Claude API Access

You need a Claude account with API access:

• Claude Pro ($20/month) - Small repositories
• Claude Max ($100/month) - Regular development
• Claude Max ($200/month) - Large projects/teams

Set your API key:

export ANTHROPIC_API_KEY="your-api-key"

Auto-Installation Dependencies

The tool automatically installs:

• Claude Code SDK (@anthropic-ai/claude-code)
• Required Node.js dependencies

🎯 Examples

Basic Usage

# Simple commit with auto-generated message (will auto-stage, commit, and push)
claude-auto-commit
Commit without auto-push (recommended for beginners)
claude-auto-commit -n
Skip push confirmation prompt
claude-auto-commit -y
Generate message without committing (dry-run)
claude-auto-commit --dry-run
Show detailed change summary
claude-auto-commit --summary
Manual file selection without auto-push
claude-auto-commit -s -n
Custom branch and emoji
claude-auto-commit -b develop -e
English with conventional commits
claude-auto-commit -l en -c -t feat
Custom message, no push
claude-auto-commit -m "Custom commit message" -n

Advanced Options

# Manual staging with verbose output
claude-auto-commit -s -v
Custom prefix for hotfix
claude-auto-commit -p "[HOTFIX]" -t fix
Preview message without committing
claude-auto-commit --dry-run
Show detailed change statistics
claude-auto-commit --summary
Combine options for detailed preview
claude-auto-commit --dry-run --summary -v
Template management
claude-auto-commit --save-template hotfix "🔥 HOTFIX: {description}"
claude-auto-commit --template hotfix
claude-auto-commit --list-templates
Update tool
claude-auto-commit --update

🔧 Installation Methods

Method 1: Installation Script (Recommended)

curl -fsSL https://raw.githubusercontent.com/0xkaz/claude-auto-commit/main/scripts/install.sh | bash

Method 2: Download from GitHub Releases

# Download the latest release
curl -L -o claude-auto-commit https://github.com/0xkaz/claude-auto-commit/releases/latest/download/claude-auto-commit.sh
chmod +x claude-auto-commit
sudo mv claude-auto-commit /usr/local/bin/

Method 3: Clone and Install

git clone https://github.com/0xkaz/claude-auto-commit.git
cd claude-auto-commit
chmod +x src/claude-auto-commit.sh
sudo ln -s $(pwd)/src/claude-auto-commit.sh /usr/local/bin/claude-auto-commit

Method 4: Direct Script Usage

# For development or testing
git clone https://github.com/0xkaz/claude-auto-commit.git
cd claude-auto-commit
./src/claude-auto-commit.sh [options]

⚙️ Configuration

Create ~/.claude-auto-commit/config.yml:

auto_update:
  enabled: true
  frequency: daily  # daily/weekly/manual/always
  silent: false
defaults:
language: en
branch: main
emoji: false
conventional: false
git:
auto_stage: true
auto_push: true

🚀 What's New in v0.1.4

• Claude Code SDK Migration: Migrated from Claude CLI to modern Claude Code SDK
  • Enhanced performance with parallel processing and intelligent caching
  • Exponential backoff retry mechanism for improved reliability
  • Template system with persistent storage
  • JSON configuration file support
• NPM Package Distribution: Available via npx claude-auto-commit
• OAuth Authentication: No API key required for Claude Pro/Max users
• ES Modules Architecture: Modern JavaScript with Node.js 22+ support
• Smart placeholders: Use {variable} in templates for dynamic values

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Anthropic for Claude CLI
• Conventional Commits specification
• Open source community for inspiration

---

Made with ❤️ for the developer community

Report Issues | Request Features | Documentation