Installation

Requirements

The npm package is named lazycommitt (double t). The commands are lazycommit and lzc.

Install

npm

npm install -g lazycommitt

Homebrew

brew tap KartikLabhshetwar/lazycommit https://github.com/KartikLabhshetwar/lazycommit
brew install lazycommit

Set your API key

lazycommit config set GROQ_API_KEY="gsk_your_key_here"

Use the key for your provider instead, for example OPENAI_API_KEY or ANTHROPIC_API_KEY. See Providers for the full list. Groq keys must start with gsk_. Keys are saved in ~/.lazycommit, and lazycommit requests owner-only file permissions for that file.

You can also set the key in your environment. It overrides the saved key.

export GROQ_API_KEY="gsk_your_key_here"

--preview-diff does not need an API key. See Configuration for all settings.

Verify

lazycommit --version
lazycommit --help

Then, inside a repository with staged changes, generate a message without committing:

lazycommit --dry-run

Upgrade

Check your installed version:

lazycommit --version

If it is not the latest version on npm, upgrade with npm:

npm update -g lazycommitt

Or, for a Homebrew installation:

brew update
brew upgrade lazycommit

Coming from 2.x: version 3 needs Node.js 22.13 or newer and supports multiple providers. Your saved GROQ_API_KEY keeps working, but a key for a provider earlier in the list (for example OPENAI_API_KEY in your shell) now wins. To stay on Groq, run lazycommit config set model=groq/openai/gpt-oss-20b.

New in 3.1: with nothing staged, lzc opens a file picker; lzc <branch> pushes after committing; lzc model picks a model from a list. Scripts are unaffected: --yes and runs without a terminal still need staged changes. See Usage.

Next steps

On this page