zencommit

AI-powered git commit message generator. Analyzes your staged changes and generates meaningful, conventional commit messages using LLMs.

Features

- Smart Diff Analysis - Automatically parses and prioritizes code changes for optimal context
- Auto Token Capping - Intelligently truncates diffs based on model token limits
- Multiple Providers - Supports 20+ AI providers via Vercel AI SDK
- Conventional Commits - Generates messages following conventional commit standards
- Interactive Workflow - Preview, edit, or confirm before committing
- Flexible Configuration - Global, project, and CLI-level configuration options
- Secure Credential Storage - API keys stored securely via Bun's Secrets API

Installation

$3

``bash
npm install -g zencommit
`

$3

`bash
bun install -g zencommit
`

$3

`bash
git clone https://github.com/mboisvertdupras/zencommit.git
cd zencommit
bun install
bun run build:exe
`

Quick Start

1. Set up your API key:

`bash
zencommit auth login
`

2. Stage your changes and run:

`bash
git add .
zencommit
`

3. Review, edit, or confirm the generated commit message.

Usage

$3

`bash


Generate commit message for staged changes

zencommit

Auto-commit without confirmation

zencommit --yes

Preview without committing

zencommit --dry-run

Stage all changes and generate message

zencommit --all

Stage all changes (short flag)

zencommit -a

Generate message for unstaged changes (preview only)

zencommit --unstaged
`

$3

| Flag | Description |
| ------------------ | --------------------------------------------------- |
| --yes | Skip confirmation and commit immediately |
| --dry-run | Preview output without committing |
| --all, -a | Stage all changes (git add -A) before generating |
| --unstaged | Use unstaged diff (never commits unless --commit) |
| --commit | Allow committing with --unstaged |
| --push, -p | Push after committing |
| --model | Override model (e.g., openai/gpt-4o) |
| --format