GitBot

AI-powered Git commit message generator. Uses staged diff only; works with Ollama, OpenAI, Anthropic, Groq.

Install

# npm (package name: gitbot-cli)
npm install -g gitbot-cli

# pnpm
pnpm add -g gitbot-cli

# yarn
yarn global add gitbot-cli

# bun
bun add -g gitbot-cli

Then run gitbot init or gitbot-cli init in your repo (creates .git if missing), then gitbot commit or gitbot-cli commit to commit. Both command names work after install.

Quick Start (from source)

pnpm install && pnpm build

# First time: set up config (creates .git if missing)
./dist/index.js init

# Stage and commit
git add .
./dist/index.js commit

Config

.gitbotrc.json in project root. Run ./dist/index.js init to create it. Set provider to ollama (default), openai, anthropic, or groq; put API keys in env (OPENAI_API_KEY, etc.).

Commands

| Command | Description | |---------|-------------| | ./dist/index.js init | Interactive setup; runs git init if no .git | | ./dist/index.js commit | Generate message from staged diff and commit | | ./dist/index.js status | Show staged summary and config | | ./dist/index.js config | Show config; --init creates .gitbotrc.json | | gitbot add [paths...] | With paths: stage only those files. With no paths: AI recommends what to stage (-m for context). |

Options for commit: --dry-run, -y (skip prompts), --no-verify, --amend. Override provider/model with -p, -m.

.gitbotignore

Exclude paths from diff analysis (e.g. .env, *.key). Same pattern syntax as .gitignore.

Proprietary. See LICENSE (EULA) for terms.