# AI Git Narrator — Generate Commit & PR Text

> Generate commit messages and PR descriptions from diffs with OpenAI/Gemini/Ollama options; verified 118★ and installs via Homebrew on macOS.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

```bash
brew tap pmusolino/ai-git-narrator
brew install ai-git-narrator
ai-git-narrator --generate-commit-message --api-key "$OPENAI_API_KEY"
```

## Intro

Generate commit messages and PR descriptions from diffs with OpenAI/Gemini/Ollama options; verified 118★ and installs via Homebrew on macOS.

**Best for:** Teams that want consistent, descriptive git history

**Works with:** macOS · Git repos · OpenAI/Gemini keys or local Ollama

**Setup time:** 5–12 minutes

### Key facts (verified)

- GitHub: 118 stars · 6 forks · pushed 2026-01-18.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `brew tap pmusolino/ai-git-narrator`.

## Main

- Use it as a git-writing copilot: generate commit text from staged/unstaged changes and keep messages consistent.

- Switch providers with `--llm-provider` (OpenAI, Gemini, or Ollama) and choose models via `--model`.

- Tune output length and variability with `--max-tokens` and `--temperature` as shown in README options.

- Use `--generate-pr` for PR description drafts based on commit history and base-branch diffs.

### Source-backed notes

- README states it’s a macOS-focused CLI that generates commit messages and PR descriptions from diffs/commits.
- README provides Homebrew installation (`brew tap` + `brew install`) and lists flags for provider/model settings.

### FAQ

- **Do I need an API key?**: For OpenAI/Gemini yes; README notes Ollama can work without a hosted API key.
- **Is it cross-platform?**: README emphasizes macOS; treat other OS support as out of scope unless verified.
- **How do I keep messages consistent?**: Pin `--model` and keep `--temperature` low for more deterministic output.

## Source & Thanks

> Source: https://github.com/pmusolino/AI-Git-Narrator
> License: MIT
> GitHub stars: 118 · forks: 6

---

<!-- ZH -->

## Quick Use

```bash
brew tap pmusolino/ai-git-narrator
brew install ai-git-narrator
ai-git-narrator --generate-commit-message --api-key "$OPENAI_API_KEY"
```

## Intro

从 Git diff 自动生成提交信息与 PR 描述，支持 OpenAI/Gemini/Ollama；已验证 118★，macOS 可用 Homebrew 安装并用 `--api-key` 配置。

**Best for:** 希望提交历史更一致、更易读的开发团队

**Works with:** macOS · Git 仓库 · OpenAI/Gemini 密钥或本地 Ollama

**Setup time:** 5–12 minutes

### Key facts (verified)

- GitHub：118 stars · 6 forks；最近更新 2026-01-18。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口命令：`brew tap pmusolino/ai-git-narrator`。

## Main

- 把它当成写 Git 文案的副驾驶：从 staged/unstaged 变更生成提交信息，统一风格与质量。

- 用 `--llm-provider` 在 OpenAI/Gemini/Ollama 间切换，并用 `--model` 选择具体模型。

- 按 README 参数用 `--max-tokens`/`--temperature` 控制输出长度与发散程度。

- 用 `--generate-pr` 基于提交历史生成 PR 描述草稿，减少写作时间。

### Source-backed notes

- README 说明它是面向 macOS 的 CLI，可基于 diff/commits 生成提交信息与 PR 描述。
- README 给出 Homebrew 安装方式，并列出 provider/model 等可配置参数与用法。

### FAQ

- **必须有 API key 吗？**：用 OpenAI/Gemini 需要；README 表示 Ollama 场景可不依赖云端密钥。
- **跨平台吗？**：README 强调 macOS；其它系统不做假设，按实际验证为准。
- **怎么让风格更一致？**：固定 `--model`，并把 `--temperature` 调低以增强确定性。

## Source & Thanks

> Source: https://github.com/pmusolino/AI-Git-Narrator
> License: MIT
> GitHub stars: 118 · forks: 6


---
Source: https://tokrepo.com/en/workflows/ai-git-narrator-generate-commit-pr-text
Author: Script Depot