Git AI Commit

AI-powered CLI that generates conventional commit messages based on your staged Git diff.

Installation

``bash


clone and enter the repository

git clone https://github.com/onaries/git-ai-commit.git
cd git-ai-commit

install dependencies and compile TypeScript

npm install
npm run build

optional: link globally to use the CLI anywhere

npm link
`

If the package is published to npm, it can be installed directly in another project:

`bash


local install

npm install @ksw8954/git-ai-commit

or install globally to use the CLI everywhere

npm install -g @ksw8954/git-ai-commit
`

Usage

After linking globally (npm link) or installing via npm, run:

$3

`bash


generate a commit message from staged changes and confirm before committing

git-ai-commit commit

print only the generated message without touching git

git-ai-commit commit --message-only

pass extra instructions to guide the AI (appended to the system prompt)

git-ai-commit commit --prompt "docs 변경은 docs 타입으로, 패키지명은 scope로 포함해줘"

override API settings for a single run

git-ai-commit commit --api-key --base-url --model

create and push the commit in one flow (will prompt for confirmation first)

git-ai-commit commit --push

combine with message-only to preview with custom guidance

git-ai-commit commit --message-only --prompt "스코프는 패키지 디렉터리명으로 설정"
`

The command previews the AI-generated message, then asks Proceed with git commit? (y/n) before creating the commit. Use --push to push after a successful commit, or set auto push through the config command (see below). You can also provide additional instructions for this run using --prompt ""; the text is appended to the AI's system prompt to guide the style/content.

During development you can run the CLI without building by using the dev script:

`bash
npm run dev -- commit
`

$3

`bash


create a PR title and body by diffing two branches

git-ai-commit pr --base main --compare feature/add-cache

override API settings for the PR run only

git-ai-commit pr --base release --compare hotfix/urgent --api-key
`

The PR command compares the Git diff from the base branch to the compare branch and prints a ready-to-paste pull request title with ## Summary and ## Testing sections in your configured language.

$3

`bash


create an annotated tag with a manual message (skips AI)

git-ai-commit tag v1.2.3 --message "Release notes"

generate release notes from commit history since a base tag

git-ai-commit tag v1.3.0 --base-tag v1.2.3

guide the AI with additional instructions for this tag

git-ai-commit tag v1.4.0 --prompt "사용자 기능/버그 수정/유지 보수로 묶고 한국어로 간결히"

you can combine both

git-ai-commit tag v1.5.0 --base-tag v1.4.0 --prompt "docs는 별도 섹션, breaking change 강조"
`

When AI generation is used, the CLI previews the tag message and asks for confirmation before creating the tag:
- Create annotated tag ? (y/n)
- After creation, it asks whether to push: Push tag to remote? (y/n)

Providing --message uses your text verbatim but still asks for tag creation confirmation.

Configuration

Persist defaults without exporting environment variables through the interactive config command:

`bash
git-ai-commit config --show # display merged configuration
git-ai-commit config --language en # set default AI output language
git-ai-commit config --auto-push # push automatically after confirmed commits
git-ai-commit config --no-auto-push # disable automatic pushing
git-ai-commit config -k sk-... # store API key securely on disk
git-ai-commit config -b https://api.test # set a custom API base URL
git-ai-commit config --model gpt-4o-mini # set preferred model
git-ai-commit config --mode openai # prefer OPENAI_* environment variables
`

The stored configuration works alongside environment variables—CLI flags override config values, which in turn override .env settings.

Configuration is written to ~/.git-ai-commit/config.json by default. Set GIT_AI_COMMIT_CONFIG_PATH=/custom/path.json to use a different location.

Environment Variables

Set the following variables (e.g., in a local .env file) before using the CLI:

- AI_MODE controls which provider defaults to: openai prioritises OPENAI_ vars; any other value (or unset) uses the AI_ vars first and falls back to OPENAI_*.
- Credentials: AI_API_KEY or OPENAI_API_KEY.
- Base URLs: AI_BASE_URL or OPENAI_BASE_URL (priority matches the selected mode).
- Models: AI_MODEL or OPENAI_MODEL (priority matches the selected mode).

Development Commands

`bash
npm run lint # run ESLint with the repository rules
npm run test # execute the Jest suite
npm run test:watch # watch mode for tests
npm run typecheck # TypeScript type checking without emit
`

$3

`bash


show all history (most recent last)

git-ai-commit history

show last N entries

git-ai-commit history --limit 20

output as JSON

git-ai-commit history --json --limit 10

clear all history (asks for confirmation)

git-ai-commit history --clear
``