tgit 0.34.1

AI-powered Git CLI for commits, changelogs, and semantic versioning.

🚀 TGIT - Tool for Git Interaction Temptation

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

🔗 Links

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

✨ Features

🤖 AI-Powered Commits

• 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

📝 Automated Changelog

• 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

🔢 Intelligent Version Management

• 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)

Supported version file formats

Ecosystem	File	Notes
Node / npm	package.json	"version": "x.y.z"
Python	pyproject.toml	[project].version, [tool.poetry].version, [tool.flit.metadata].version, [tool.setuptools]
Python	__about__.py	__version__ = "x.y.z" — auto-discovered via [tool.hatch.version].path, [tool.hatch.build.targets.wheel].packages, or [project].name (also checks src/<pkg>/)
Python	__init__.py	__version__ = "x.y.z" — only files that actually define __version__ are touched, located in the same package dirs as __about__.py
Python	setup.py	version="x.y.z"
Rust	Cargo.toml	version inside the [package] section only
Gradle (Kotlin DSL)	build.gradle.kts	version = "x.y.z"
Dart / Flutter	pubspec.yaml	version: x.y.z (supports +build and quoted values)
Helm	Chart.yaml	version: x.y.z (apiVersion and appVersion are left untouched)
Generic	VERSION, VERSION.txt	Plain-text file containing only the version string

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.

⚙️ Flexible Configuration

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

🚀 Quick Start

Installation

uv tool install tgit

pipx install tgit

pip install tgit

Basic Usage

# 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

Configuration

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: "🐛"

📖 Commands

Commit

# AI-powered commit
tgit commit

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

Changelog

# 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

Version

# 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

Settings

# 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.

🛠️ Development

Setup

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

# Install dependencies
uv sync

Testing

# 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

Code Quality

# Run linting
uv run ruff check .

# Run formatting
uv run ruff format .

# Build package
uv build

📄 License

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

🤝 Contributing

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.

📞 Support

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