genai-commit

AI-powered commit message generator using Claude Code or Cursor CLI.

Features

• AI-powered commit messages - Generate meaningful commit messages using Claude Code or Cursor CLI
• Conventional Commits - Automatically follows the Conventional Commits specification
• Multi-language support - Generate titles and messages in English or Korean
• Jira integration - Assign Jira tickets to commits and auto-merge related changes
• Interactive workflow - Review, provide feedback, and refine before committing
• Smart file grouping - Intelligently splits changes into logical commits

How It Works

flowchart TD
    A[Start: genai-commit] --> B[Collect Git Changes]
    B --> C{Changes Found?}
    C -->|No| D[Exit: No changes]
    C -->|Yes| E[Generate Tree Summary]
    E --> F[Build AI Prompt]
    F --> G{Select Provider}
    G -->|Claude Code| H[Claude Code CLI]
    G -->|Cursor CLI| I[Cursor CLI]
    H --> J[Parse JSON Response]
    I --> K[Parse Delimiter Response]
    J --> L[Display Proposed Commits]
    K --> L
    L --> M{User Action}
    M -->|y| N[Execute git add + commit]
    M -->|n| O[Cancel]
    M -->|f| P[Get Feedback]
    M -->|t| Q[Assign Jira Tickets]
    P --> F
    Q --> R[Merge Same-Ticket Commits]
    R --> L
    N --> S[Done]

Prerequisites

You need at least one of these AI CLI tools installed:

• Claude Code CLI - Anthropic's official CLI
• Cursor Agent CLI - Cursor's agent CLI (command: agent)

Installation

# Global installation
npm install -g genai-commit

# Or use directly with npx (no installation required)
npx genai-commit claude-code

Usage

Generate Commit Messages

# Using Claude Code
genai-commit claude-code

# Using Cursor Agent
genai-commit cursor-cli

# With specific model
genai-commit cursor-cli --model claude-4.5-sonnet
genai-commit claude-code --model sonnet

# Set language for both title and message
genai-commit claude-code --lang ko

# Set languages separately
genai-commit claude-code --title-lang en --message-lang ko

Authentication

# Login to Cursor Agent
genai-commit login cursor-cli

# Setup Claude token
genai-commit login claude-code

# Check status
genai-commit status claude-code
genai-commit status cursor-cli

List Supported Models

# List models for Cursor Agent
genai-commit models cursor-cli

# List models for Claude Code
genai-commit models claude-code

Interactive Options

After generating commit messages, you'll see an interactive menu:

| Option | Description | |--------|-------------| | [y] | Commit all proposed commits | | [n] | Cancel | | [f] | Provide feedback to regenerate | | [t] | Assign Jira tickets and regroup commits |

Options

| Option | Description | Default | |--------|-------------|---------| | --lang <lang> | Set both title and message language (en|ko) | - | | --title-lang <lang> | Language for commit title | en | | --message-lang <lang> | Language for commit message | ko | | --model <model> | Model to use | claude-4.5-sonnet (Cursor) / haiku (Claude) |

Examples

Basic Usage

# Navigate to your git repository
cd my-project

# Make some changes
echo "console.log('hello');" >> src/index.js

# Generate and create commits
genai-commit claude-code

With Jira Integration

1. Run genai-commit claude-code
2. Review proposed commits
3. Press t to assign Jira tickets
4. Enter Jira URLs for each commit
5. Commits with the same Jira ticket are automatically merged
6. Press y to commit

Providing Feedback

1. Run genai-commit cursor-cli
2. Review proposed commits
3. Press f to provide feedback
4. Enter your feedback (e.g., "Split the auth changes into separate commits")
5. AI regenerates based on your feedback
6. Press y to commit

Supported Commit Types

Following the Conventional Commits specification:

| Type | Description | |------|-------------| | feat | New feature | | fix | Bug fix | | docs | Documentation | | style | Formatting (no code change) | | refactor | Code restructuring | | test | Adding tests | | chore | Maintenance | | perf | Performance improvement | | ci | CI/CD changes | | build | Build system changes |

Configuration

The tool uses sensible defaults but can be configured:

| Setting | Default | Description | |---------|---------|-------------| | maxInputSize | 30000 | Maximum input size in bytes | | maxDiffSize | 15000 | Maximum diff size in bytes | | timeout | 120000 | AI request timeout in ms | | treeDepth | 3 | Directory depth for tree compression |

Requirements

• Node.js >= 18.0.0
• Git repository
• Claude Code CLI or Cursor CLI installed and authenticated

License

MIT