giv - AI-Powered Git History Assistant

giv

AI-Powered Git History Assistant

Transform raw Git history into polished commit messages, summaries, changelogs, and release notes. Self-contained binaries with zero dependencies and multiple AI backend support.

🚀 Get Started View Source
diff --git a/auth.py b/auth.py
@@ -1,8 +1,15 @@
+import jwt
+from datetime import datetime, timedelta
def authenticate_user(username, password):
- # TODO: implement authentication
- return False
+ if verify_credentials(username, password):
+ token = jwt.encode({
+ 'user': username,
+ 'exp': datetime.utcnow() + timedelta(hours=24)
+ }, SECRET_KEY)
+ return token
+ return None

$ giv message

feat: implement JWT-based user authentication - Add JWT token generation for authenticated users - Replace placeholder authentication with real implementation - Set 24-hour token expiration for security - Return signed JWT token on successful authentication
✓ Generated in 2.3 seconds

AI-Powered Git Workflows

Professional documentation from your Git history

🤖

Multiple AI Backends

Works with OpenAI, Anthropic, Ollama, and any OpenAI-compatible API. Switch providers or run completely offline with local models.

📦

Self-Contained Binaries

Download once, run everywhere. No Python installation required. Cross-platform binaries for Linux, macOS, and Windows.

⚡

Rich Command Suite

Generate commit messages, summaries, changelogs, release notes, and marketing announcements from your Git history.

🎯

Smart Git Integration

Support for revision ranges, pathspecs, staged changes, and full gitrevisions syntax. Works with your existing Git workflow.

🔧

Template System

Customizable prompts for all output types. Project and user-level settings with inheritance and variable substitution.

📊

Version Intelligence

Automatic SemVer detection, changelog management, and release note generation with proper version bumping.

Installation

Get giv running in seconds

⚡

Quick Install

# One-line install script curl -fsSL https://raw.githubusercontent.com/fwdslsh/giv/main/install.sh | sh # Start using immediately giv init giv message

Automatically detects your platform and installs the binary

🐍

Python Package

# Install via pip pip install giv # Or use pipx for isolation pipx install giv

Available on PyPI for Python 3.9+

🐳

Docker

# Pull latest image docker pull fwdslsh/giv:latest # Run commands docker run --rm fwdslsh/giv message

Containerized for reproducible builds

Supported AI Providers

Use your preferred AI service or run completely offline

OpenAI

GPT-4, GPT-3.5-turbo

Anthropic

Claude 3.5 Sonnet, Claude 3 Opus

Ollama (Local)

Llama 3.2, Code Llama, Mistral

Custom API

Any OpenAI-compatible endpoint

⚙️

Configuration Guide

Set up your preferred AI provider

 📖

Provider Examples

See configuration for each provider

How It Works

From Git history to professional documentation

1

Extract Git History

Analyzes commits, diffs, and metadata using Git revision syntax

2

AI Processing

Sends context to your configured AI provider with custom prompts

3

Generate Content

Creates commit messages, changelogs, or release notes based on changes

4

Apply & Format

Outputs ready-to-use content in your preferred format and location

2.3s
Average Generation Time
4
AI Providers Supported
0
Runtime Dependencies
5
Output Formats

Ready to Transform Your Git Workflow?

Get started with giv today

🚀 Getting Started Guide 📚 View Examples 📥 Download Binary
📂

Source Code

View on GitHub, report issues, contribute

 🐍

PyPI Package

Install via pip, view release history

 🐳

Docker Hub

Pull container images, view tags