@jerryshell/aicommits

AI-powered git commit message generator. Fork of nutlope/aicommits.

Features and changes

• Structured output: Uses Zod schemas + Output.object() to enforce JSON responses, eliminating parsing fragility from free-text LLM output.
• No reasoning tokens: All LLM calls disable reasoning (reasoning: "none", sent as reasoning_effort: "none" on OpenAI-compatible endpoints), skipping thinking tokens on models that support it.
• Large-diff summarization: Diffs over 30 KB are condensed locally into a per-file skeleton (stat + key declarations) instead of sending truncated raw diff text, cutting tokens ~10× on big commits. Small diffs are sent verbatim.
• Interactive editing: After generation, use the arrow keys to choose Yes, Edit, or No; Edit lets you revise the message before committing.
• Bun for dev, Node for prod: Dev tooling uses Bun (faster builds, oxfmt, oxlint). Production binary targets Node.

Install

npm add -g @jerryshell/aicommits

Quick start

aicommits setup   # configure your API endpoint and key, pick a model
aicommits         # generate a commit message from staged changes
# tip: `aic` works too (same thing, shorter)

Development

git clone https://github.com/jerryshell/aicommits.git
cd aicommits
bun install
bun run build
bun link

Commands

Command	Description
aicommits	Generate commit message from staged changes
aicommits setup	Configure API endpoint and key
aicommits model	Select or change AI model
aicommits pr	Generate PR from branch diff
aicommits config	View/edit config
aicommits hook	Install git hooks

Flags

Flag	Description
-g, --generate <n>	Number of messages to generate
-t, --type <format>	Format: plain, conventional, conventional+body, gitmoji, subject+body
-a, --all	Auto-stage all tracked changes
-y, --yes	Skip confirmation
-c, --clipboard	Copy message to clipboard instead of committing
-n, --no-verify	Bypass pre-commit hooks
-p, --prompt <text>	Custom prompt for the LLM
-x, --exclude <files>	Files to exclude from AI analysis

Providers

Any OpenAI-compatible endpoint works: OpenAI, Groq, xAI, Together, Ollama, LM Studio, vLLM, or a custom server. aicommits setup asks for the base URL and API key; no per-provider presets or hardcoded defaults. Local endpoints (e.g. Ollama) can use an empty API key.