gitta 0.1.5

AI-powered Git commit message generator from your terminal

gitta

AI-powered Git commit messages and PR descriptions from your terminal.

Installation

pip install gitta

Quick Start

gitta init          # Set up your AI provider
gitta add .         # Stage files + generate commit message
gitta ship          # Stage, commit, and push in one step
gitta pr --create   # Generate and create a PR on GitHub

Usage

Setup

Run the interactive setup wizard to configure your AI provider:

gitta init

You'll be prompted for your provider name, API base URL, model, commit style, and API key. Your API key is stored securely in the system keyring.

Committing

Generate an AI-powered commit message from your staged changes:

gitta add .              # Stage files + generate message
gitta commit             # Generate message for already-staged files
gitta commit --dry-run   # Preview without committing

You'll see the generated message and can confirm (y), edit (e), or cancel (n).

Split Commits

When changes span multiple modules, use --split to create scoped commits:

gitta commit --split
gitta add . --split
gitta ship --split

Gitta groups changes by module (e.g. cli, ai, core) and generates a message for each. You can then commit all separately, merge into one, or cancel.

To enable by default:

gitta config set multi_file true

Ship

Stage everything, generate a commit message, and push — all in one step:

gitta ship

Branch Names

Generate a branch name from a natural language description:

gitta branch "fix login timeout"           # → fix/login-timeout
gitta branch "add user avatar upload" -c   # Create and checkout the branch

Pull Requests

Generate a PR title and description from all commits on your branch:

gitta pr                    # Preview the generated title + body
gitta pr --create           # Push branch and create PR on GitHub
gitta pr --create --draft   # Create as draft
gitta pr --base develop     # Compare against a specific base branch

When creating, you can confirm (y), edit (e), or cancel (n) before the PR is submitted. Requires the GitHub CLI (gh).

Explain

Explain what a commit or file change does in plain English:

gitta explain abc1234        # Explain a commit
gitta explain src/main.py    # Explain uncommitted changes to a file

Merging

Merge the PR for your current branch directly from the terminal:

gitta merge              # Merge commit (default)
gitta merge --squash     # Squash and merge
gitta merge --rebase     # Rebase and merge
gitta merge -D           # Merge without deleting the remote branch

Requires the GitHub CLI (gh).

Utilities

gitta log                       # Show recent commits in a table
gitta log -n 20                 # Show last 20 commits
gitta config list               # Show all config values
gitta config get <key>          # Get a config value
gitta config set <key> <value>  # Update a config value
gitta doctor                    # Diagnose setup issues

Configuration

Config is stored in ~/.gitta/config.toml. Available settings:

Key	Description	Default
provider	AI provider name (e.g. openai)	—
base_url	API endpoint	—
model	Model identifier (e.g. gpt-4o)	—
style	Commit format: conventional, simple, detailed	—
max_diff_chars	Max diff size sent to AI	32000
multi_file	Enable split commits by default	false