TGIT is an AI-powered Git CLI for commit messages, changelog generation, and semantic versioning.

• Generate conventional commits from staged changes
• Build changelogs from commit history
• Bump versions across common project files
• Manage settings from .tgit.yaml or an interactive CLI

• Repository: https://github.com/Jannchie/tgit
• Issues: https://github.com/Jannchie/tgit/issues
• Changelog: https://github.com/Jannchie/tgit/blob/main/CHANGELOG.md

• Generate conventional commit messages automatically using OpenAI
• Smart diff analysis that focuses on meaningful changes
• Support for custom commit types and emojis
• Breaking change detection
• Two-level secret scanning: prompts (default yes) for key names and blocking prompts for exposed values

• Generate beautiful, structured changelogs from conventional commits
• Group commits by type with emoji categorization
• Support for multiple output formats
• Automatic git remote URL detection for commit links

• Semantic versioning with pre-release support
• Automatic version bumping based on commit history
• Git tagging integration
• Detects and updates version strings across many project file formats (see below)

If no version file is found, TGIT falls back to the latest v* git tag.

In recursive mode (default), TGIT walks the working tree to bump every detected file at once — useful for monorepos. Use --no-recursive to limit updates to the project root.

• Global and workspace-specific settings
• YAML-based configuration files
• Interactive settings management
• Customizable commit types and emojis

uv tool install tgit

pipx install tgit

pip install tgit

# Configure TGIT
tgit settings

# Generate an AI-powered commit message from staged changes
tgit commit

# Generate changelog for current version
tgit changelog

# Bump version and generate changelog
tgit version

The recommended way to configure TGIT is through the interactive settings command:

# Interactive configuration - recommended!
tgit settings

This will guide you through setting up:

• OpenAI API key for AI-powered commits
• Preferred AI model (gpt-5-mini, gpt-4.1, etc.)
• Optional reasoning effort override (none, minimal, low, medium, high, xhigh)
• Commit emoji preferences
• Custom commit types
• Global and workspace settings paths during view and save flows
• Workspace overrides using effective defaults, with empty values falling back to inherited settings

Alternatively, you can manually create a .tgit.yaml file in your project root or ~/.tgit.yaml for global settings:

apiKey: "your-openai-api-key"
model: "gpt-5-mini"
reasoning_effort: "medium"
commit:
  emoji: true
  types:
    - type: "feat"
      emoji: "✨"
    - type: "fix"
      emoji: "🐛"

# AI-powered commit
tgit commit

# Breaking change commit
tgit commit --breaking "remove deprecated api"

# Generate changelog for current version
tgit changelog

# Generate changelog from specific version
tgit changelog --from v1.0.0

# Generate changelog to specific version
tgit changelog --to v2.0.0

# Interactive version bump
tgit version

# Limit to root only (disable recursive bump)
tgit version --no-recursive

# Bump specific version type
tgit version --patch
tgit version --minor
tgit version --major

# Pre-release version
tgit version --prerelease alpha

# Interactive settings configuration
tgit settings

# Show current settings
tgit settings --show

When configuring workspace settings interactively, TGIT shows the effective values that are currently in use. Leave a string field empty to inherit from the global/default value, or choose Follow global/default for boolean settings.

You can also override the default reasoning effort used for AI commit generation with reasoning_effort. Use auto in the non-interactive settings command, or leave the field empty in interactive settings, to omit the field and fall back to the model-specific default. Those defaults vary by model family, for example gpt-5 defaults to medium, while gpt-5.4-mini defaults to none.

# Clone the repository
git clone https://github.com/Jannchie/tgit.git
cd tgit

# Install dependencies
uv sync

# Run all tests
./scripts/test.sh

# Run with coverage
./scripts/test.sh --coverage 90

# Run specific test types
./scripts/test.sh --unit
./scripts/test.sh --integration

# Run linting
uv run ruff check .

# Run formatting
uv run ruff format .

# Build package
uv build

This project is licensed under the MIT License - see the LICENSE file for details.

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

If you encounter any problems or have suggestions, please open an issue on GitHub.