AI Git Narrator

AI Git Narrator is a command‑line utility for macOS that creates commit messages and pull‑request descriptions from Git diffs and commit history. It connects to OpenAI’s GPT models, Google’s Gemini models, or local Ollama LLMs, allowing developers to choose the AI provider that best fits their workflow. By processing staged, unstaged, or all changes, it produces concise, descriptive messages that can be used directly in the repository.

The tool is built with Swift 6.x and integrates with macOS native capabilities, offering configurable parameters such as model selection, token limits, and temperature to tailor output. Users supply API keys for cloud providers or point to a local Ollama server, and the executable can be installed via Homebrew or compiled from source.

Typical usage involves invoking the binary with flags that specify the desired operation—generating a commit message, a staged‑only message, an unstaged message, or a full PR description—along with any provider‑specific options. The result is an automated, consistent Git history that reduces manual effort while preserving clarity for collaborators.