lean-commit (cmit)

A local-first, zero-discipline Git CLI that converts messy developer commit history (test fix, weird bug 2, still broken) into clean, AI-summarized Conventional Commits and release notes without cloud API keys or manual changelog maintenance.

Key Features

• [Local AI Engine]: Analyzes git diffs completely offline using embedded small language models via node-llama-cpp or a local Ollama instance without external API keys.
• [Automated Anchor Discovery]: Scans backward through git history to locate the last properly tagged release or conventional commit, automatically aggregating all intermediate WIP commits.
• [Intent-Driven Prompts]: Captures high-level developer intent (feat, fix, breaking) via interactive terminal prompts to calculate Semantic Versioning impact.
• [Interactive Review Loop]: Displays AI-generated summaries directly in the terminal with options to approve, edit in your system $EDITOR, or re-generate before pushing.

Quick Start

Execute directly in any Git repository using npx:

npx lean-commit
# or using the short binary alias
npx cmit

Or install globally for instant terminal access:

npm install -g lean-commit
cmit

Workflow Commands & Options

• [Zero-Install Execution]: Run transiently inside any project folder without modifying package.json or creating local node_modules.
• [Global Binary Alias]: Invoke the abbreviated cmit binary globally across any local repository on your system.

Environment Configuration

• [OLLAMA_HOST]: Specifies a local Ollama server address to reuse existing local LLMs instead of streaming embedded model weights.
• [EDITOR]: Defines your preferred terminal or GUI editor spawned during the changelog review step.