gac 1.9.4__tar.gz → 1.9.5__tar.gz

gac-1.9.5/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: gac
+Version: 1.9.5
+Summary: LLM-powered Git commit message generator with multi-provider support
+Project-URL: Homepage, https://github.com/cellwebb/gac
+Project-URL: Documentation, https://github.com/cellwebb/gac#readme
+Project-URL: Repository, https://github.com/cellwebb/gac.git
+Project-URL: Issues, https://github.com/cellwebb/gac/issues
+Project-URL: Changelog, https://github.com/cellwebb/gac/blob/main/CHANGELOG.md
+Project-URL: Source, https://github.com/cellwebb/gac
+Author-email: cellwebb <cellwebb@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.10
+Requires-Dist: click>=8.3.0
+Requires-Dist: halo
+Requires-Dist: httpcore>=1.0.9
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pydantic>=2.12.0
+Requires-Dist: python-dotenv>=1.1.1
+Requires-Dist: questionary
+Requires-Dist: rich>=14.1.0
+Requires-Dist: tiktoken>=0.12.0
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: codecov; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<!-- markdownlint-disable MD013 -->
+
+# 🚀 Git Auto Commit (gac)
+
+[![PyPI version](https://img.shields.io/pypi/v/gac.svg)](https://pypi.org/project/gac/)
+[![Python](https://img.shields.io/badge/python-3.10%20|%203.11%20|%203.12%20|%203.13%20|%203.14-blue.svg)](https://www.python.org/downloads/)
+[![Build Status](https://github.com/cellwebb/gac/actions/workflows/ci.yml/badge.svg)](https://github.com/cellwebb/gac/actions)
+[![codecov](https://codecov.io/gh/cellwebb/gac/branch/main/graph/badge.svg)](https://app.codecov.io/gh/cellwebb/gac)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](https://mypy-lang.org/)
+[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](docs/CONTRIBUTING.md)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**LLM-powered commit messages that understand your code.**
+
+**Tired of writing commit messages?** Replace `git commit -m "..."` with `gac` for contextual, well-formatted commit messages generated by large language models.
+
+---
+
+## What You Get
+
+Instead of generic messages like `"update stuff"`, `"fix bug"`, or `"add feature"`, you get intelligent, contextual messages that explain the **why** behind your changes:
+
+![GAC generating a contextual commit message](assets/gac-simple-usage.png)
+
+---
+
+## Quick Start
+
+### Install & Use
+
+```bash
+# 1. Install globally
+uv tool install gac
+
+# 2. Configure your LLM provider
+gac init
+
+# 3. Use on your staged changes
+git add .
+gac
+```
+
+That's it! Review the generated message and confirm with `y`.
+
+### Use without installing
+
+```bash
+uvx gac init
+uvx gac
+```
+
+---
+
+## Key Features
+
+### **Supported Providers**
+
+- **Anthropic** • **Cerebras** • **Chutes.ai** • **Gemini** • **Groq**
+- **LM Studio** • **Ollama** • **OpenAI** • **OpenRouter**
+- **Streamlake** • **Synthetic.new** • **Z.AI** • **Z.AI Coding**
+
+### **Smart LLM Analysis**
+
+- **Understands intent**: Analyzes code structure, logic, and patterns to understand the "why" behind your changes, not just what changed
+- **Semantic awareness**: Recognizes refactoring, bug fixes, features, and breaking changes to generate contextually appropriate messages
+- **Intelligent filtering**: Prioritizes meaningful changes while ignoring generated files, dependencies, and artifacts
+
+### **Multiple Message Formats**
+
+- **One-liner** (-o flag): Single-line commit message following conventional commit format
+- **Standard** (default): Summary with bullet points explaining implementation details
+- **Verbose** (-v flag): Comprehensive explanations including motivation, technical approach, and impact analysis
+
+### **Developer Experience**
+
+- **Interactive feedback**: Regenerate messages with specific requests like `r "make it shorter"` or `r "focus on the bug fix"`
+- **One-command workflows**: Complete workflows with flags like `gac -ayp` (stage all, auto-confirm, push)
+- **Git integration**: Respects pre-commit and lefthook hooks, running them before expensive LLM operations
+
+### **Built-in Security**
+
+- **Automatic secret detection**: Scans for API keys, passwords, and tokens before committing
+- **Interactive protection**: Prompts before committing potentially sensitive data with clear remediation options
+- **Smart filtering**: Ignores example files, template files, and placeholder text to reduce false positives
+
+---
+
+## Usage Examples
+
+### Basic Workflow
+
+```bash
+# Stage your changes
+git add .
+
+# Generate and commit with LLM
+gac
+
+# Review → y (commit) | n (cancel) | r (reroll)
+```
+
+### Common Commands
+
+| Command         | Description                                    |
+| --------------- | ---------------------------------------------- |
+| `gac`           | Generate commit message                        |
+| `gac -y`        | Auto-confirm (no review needed)                |
+| `gac -a`        | Stage all + commit                             |
+| `gac -o`        | One-line message only                          |
+| `gac -v`        | Detailed verbose format                        |
+| `gac -h "hint"` | Add context for LLM (e.g., `gac -h "bug fix"`) |
+| `gac -s`        | Include scope (e.g., feat(auth):)              |
+| `gac -p`        | Commit and push                                |
+
+### Power User Examples
+
+```bash
+# Complete workflow in one command
+gac -ayp -h "release preparation"
+
+# Detailed explanation with scope
+gac -v -s
+
+# Quick one-liner for small changes
+gac -o
+
+# Debug what the LLM sees
+gac --show-prompt
+
+# Skip security scan (use carefully)
+gac --skip-secret-scan
+```
+
+### Interactive Reroll System
+
+Not happy with the result? Use the reroll feature for intelligent regeneration:
+
+```bash
+# Simple regeneration (uses previous context)
+r
+
+# With specific feedback
+r make it shorter and focus on the performance improvement
+r use conventional commit format with scope
+r explain the security implications
+```
+
+---
+
+## Configuration
+
+Run `gac init` to configure your provider interactively, or set environment variables:
+
+```bash
+# Example configuration
+GAC_MODEL=anthropic:your-model-name
+OPENAI_API_KEY=your_key_here
+ANTHROPIC_API_KEY=your_key_here
+```
+
+See `.gac.env.example` for all available options.
+
+---
+
+## Getting Help
+
+- **Full documentation**: [USAGE.md](USAGE.md) - Complete CLI reference
+- **Troubleshooting**: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) - Common issues and solutions
+- **Contributing**: [CONTRIBUTING.md](docs/CONTRIBUTING.md) - Development setup and guidelines
+
+---
+
+<!-- markdownlint-disable MD033 MD036 -->
+
+<div align="center">
+
+Made with ❤️ for developers who want better commit messages
+
+[⭐ Star us on GitHub](https://github.com/cellwebb/gac) • [🐛 Report issues](https://github.com/cellwebb/gac/issues) • [📖 Full docs](USAGE.md)
+
+</div>
+
+<!-- markdownlint-enable MD033 MD036 -->

gac-1.9.5/README.md

@@ -0,0 +1,184 @@
+<!-- markdownlint-disable MD013 -->
+
+# 🚀 Git Auto Commit (gac)
+
+[![PyPI version](https://img.shields.io/pypi/v/gac.svg)](https://pypi.org/project/gac/)
+[![Python](https://img.shields.io/badge/python-3.10%20|%203.11%20|%203.12%20|%203.13%20|%203.14-blue.svg)](https://www.python.org/downloads/)
+[![Build Status](https://github.com/cellwebb/gac/actions/workflows/ci.yml/badge.svg)](https://github.com/cellwebb/gac/actions)
+[![codecov](https://codecov.io/gh/cellwebb/gac/branch/main/graph/badge.svg)](https://app.codecov.io/gh/cellwebb/gac)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](https://mypy-lang.org/)
+[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](docs/CONTRIBUTING.md)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**LLM-powered commit messages that understand your code.**
+
+**Tired of writing commit messages?** Replace `git commit -m "..."` with `gac` for contextual, well-formatted commit messages generated by large language models.
+
+---
+
+## What You Get
+
+Instead of generic messages like `"update stuff"`, `"fix bug"`, or `"add feature"`, you get intelligent, contextual messages that explain the **why** behind your changes:
+
+![GAC generating a contextual commit message](assets/gac-simple-usage.png)
+
+---
+
+## Quick Start
+
+### Install & Use
+
+```bash
+# 1. Install globally
+uv tool install gac
+
+# 2. Configure your LLM provider
+gac init
+
+# 3. Use on your staged changes
+git add .
+gac
+```
+
+That's it! Review the generated message and confirm with `y`.
+
+### Use without installing
+
+```bash
+uvx gac init
+uvx gac
+```
+
+---
+
+## Key Features
+
+### **Supported Providers**
+
+- **Anthropic** • **Cerebras** • **Chutes.ai** • **Gemini** • **Groq**
+- **LM Studio** • **Ollama** • **OpenAI** • **OpenRouter**
+- **Streamlake** • **Synthetic.new** • **Z.AI** • **Z.AI Coding**
+
+### **Smart LLM Analysis**
+
+- **Understands intent**: Analyzes code structure, logic, and patterns to understand the "why" behind your changes, not just what changed
+- **Semantic awareness**: Recognizes refactoring, bug fixes, features, and breaking changes to generate contextually appropriate messages
+- **Intelligent filtering**: Prioritizes meaningful changes while ignoring generated files, dependencies, and artifacts
+
+### **Multiple Message Formats**
+
+- **One-liner** (-o flag): Single-line commit message following conventional commit format
+- **Standard** (default): Summary with bullet points explaining implementation details
+- **Verbose** (-v flag): Comprehensive explanations including motivation, technical approach, and impact analysis
+
+### **Developer Experience**
+
+- **Interactive feedback**: Regenerate messages with specific requests like `r "make it shorter"` or `r "focus on the bug fix"`
+- **One-command workflows**: Complete workflows with flags like `gac -ayp` (stage all, auto-confirm, push)
+- **Git integration**: Respects pre-commit and lefthook hooks, running them before expensive LLM operations
+
+### **Built-in Security**
+
+- **Automatic secret detection**: Scans for API keys, passwords, and tokens before committing
+- **Interactive protection**: Prompts before committing potentially sensitive data with clear remediation options
+- **Smart filtering**: Ignores example files, template files, and placeholder text to reduce false positives
+
+---
+
+## Usage Examples
+
+### Basic Workflow
+
+```bash
+# Stage your changes
+git add .
+
+# Generate and commit with LLM
+gac
+
+# Review → y (commit) | n (cancel) | r (reroll)
+```
+
+### Common Commands
+
+| Command         | Description                                    |
+| --------------- | ---------------------------------------------- |
+| `gac`           | Generate commit message                        |
+| `gac -y`        | Auto-confirm (no review needed)                |
+| `gac -a`        | Stage all + commit                             |
+| `gac -o`        | One-line message only                          |
+| `gac -v`        | Detailed verbose format                        |
+| `gac -h "hint"` | Add context for LLM (e.g., `gac -h "bug fix"`) |
+| `gac -s`        | Include scope (e.g., feat(auth):)              |
+| `gac -p`        | Commit and push                                |
+
+### Power User Examples
+
+```bash
+# Complete workflow in one command
+gac -ayp -h "release preparation"
+
+# Detailed explanation with scope
+gac -v -s
+
+# Quick one-liner for small changes
+gac -o
+
+# Debug what the LLM sees
+gac --show-prompt
+
+# Skip security scan (use carefully)
+gac --skip-secret-scan
+```
+
+### Interactive Reroll System
+
+Not happy with the result? Use the reroll feature for intelligent regeneration:
+
+```bash
+# Simple regeneration (uses previous context)
+r
+
+# With specific feedback
+r make it shorter and focus on the performance improvement
+r use conventional commit format with scope
+r explain the security implications
+```
+
+---
+
+## Configuration
+
+Run `gac init` to configure your provider interactively, or set environment variables:
+
+```bash
+# Example configuration
+GAC_MODEL=anthropic:your-model-name
+OPENAI_API_KEY=your_key_here
+ANTHROPIC_API_KEY=your_key_here
+```
+
+See `.gac.env.example` for all available options.
+
+---
+
+## Getting Help
+
+- **Full documentation**: [USAGE.md](USAGE.md) - Complete CLI reference
+- **Troubleshooting**: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) - Common issues and solutions
+- **Contributing**: [CONTRIBUTING.md](docs/CONTRIBUTING.md) - Development setup and guidelines
+
+---
+
+<!-- markdownlint-disable MD033 MD036 -->
+
+<div align="center">
+
+Made with ❤️ for developers who want better commit messages
+
+[⭐ Star us on GitHub](https://github.com/cellwebb/gac) • [🐛 Report issues](https://github.com/cellwebb/gac/issues) • [📖 Full docs](USAGE.md)
+
+</div>
+
+<!-- markdownlint-enable MD033 MD036 -->

{gac-1.9.4 → gac-1.9.5}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 [project]
 name = "gac"
 dynamic = ["version"]
-description = "AI-powered Git commit message generator with multi-provider support"
+description = "LLM-powered Git commit message generator with multi-provider support"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
@@ -25,13 +25,10 @@ classifiers = [
   "Programming Language :: Python :: Implementation :: PyPy",
 ]
 dependencies = [
-    # HTTP client for AI provider APIs
+    # HTTP client for LLM provider APIs
     "httpx>=0.28.0",
     "httpcore>=1.0.9",  # Required for Python 3.14 compatibility
 
-    # Anthropic SDK (token counting)
-    "anthropic>=0.68.0",
-
     # Token counting (OpenAI models)
     "tiktoken>=0.12.0",
 
@@ -45,8 +42,6 @@ dependencies = [
     "questionary",
     "rich>=14.1.0",
 
-    # Summarization and document processing
-    "sumy",
 ]
 
 [project.scripts]
@@ -136,7 +131,7 @@ include = [
 
 [tool.hatch.envs.default]
 dependencies = [
-    # AI components
+    # LLM components
     "anthropic",
     "openai",
     "groq",

{gac-1.9.4 → gac-1.9.5}/src/gac/__version__.py

@@ -1,3 +1,3 @@
 """Version information for gac package."""
 
-__version__ = "1.9.4"
+__version__ = "1.9.5"

{gac-1.9.4 → gac-1.9.5}/src/gac/main.py

@@ -294,12 +294,17 @@ def main(
                             # No hint given, just reroll with same prompts
                             reroll_system_prompt, reroll_user_prompt = system_prompt, user_prompt
 
+                        # Update prompts and recalculate token count for the next generation
+                        system_prompt = reroll_system_prompt
+                        user_prompt = reroll_user_prompt
+                        prompt_tokens = count_tokens(system_prompt, model) + count_tokens(user_prompt, model)
+
                         console.print()  # Add blank line for readability
 
                         # Generate new message
                         commit_message = generate_commit_message(
                             model=model,
-                            prompt=(reroll_system_prompt, reroll_user_prompt),
+                            prompt=(system_prompt, user_prompt),
                             temperature=temperature,
                             max_tokens=max_output_tokens,
                             max_retries=max_retries,

gac-1.9.4/PKG-INFO

@@ -1,246 +0,0 @@
-Metadata-Version: 2.4
-Name: gac
-Version: 1.9.4
-Summary: AI-powered Git commit message generator with multi-provider support
-Project-URL: Homepage, https://github.com/cellwebb/gac
-Project-URL: Documentation, https://github.com/cellwebb/gac#readme
-Project-URL: Repository, https://github.com/cellwebb/gac.git
-Project-URL: Issues, https://github.com/cellwebb/gac/issues
-Project-URL: Changelog, https://github.com/cellwebb/gac/blob/main/CHANGELOG.md
-Project-URL: Source, https://github.com/cellwebb/gac
-Author-email: cellwebb <cellwebb@users.noreply.github.com>
-License-Expression: MIT
-License-File: LICENSE
-Classifier: Development Status :: 4 - Beta
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: >=3.10
-Requires-Dist: anthropic>=0.68.0
-Requires-Dist: click>=8.3.0
-Requires-Dist: halo
-Requires-Dist: httpcore>=1.0.9
-Requires-Dist: httpx>=0.28.0
-Requires-Dist: pydantic>=2.12.0
-Requires-Dist: python-dotenv>=1.1.1
-Requires-Dist: questionary
-Requires-Dist: rich>=14.1.0
-Requires-Dist: sumy
-Requires-Dist: tiktoken>=0.12.0
-Provides-Extra: dev
-Requires-Dist: build; extra == 'dev'
-Requires-Dist: codecov; extra == 'dev'
-Requires-Dist: pre-commit; extra == 'dev'
-Requires-Dist: pytest; extra == 'dev'
-Requires-Dist: pytest-cov; extra == 'dev'
-Requires-Dist: ruff; extra == 'dev'
-Requires-Dist: twine; extra == 'dev'
-Description-Content-Type: text/markdown
-
-<!-- markdownlint-disable MD013 -->
-
-# Git Auto Commit (gac)
-
-[![PyPI version](https://img.shields.io/pypi/v/gac.svg)](https://pypi.org/project/gac/)
-[![Python](https://img.shields.io/badge/python-3.10%20|%203.11%20|%203.12%20|%203.13%20|%203.14-blue.svg)](https://www.python.org/downloads/)
-[![Build Status](https://github.com/cellwebb/gac/actions/workflows/ci.yml/badge.svg)](https://github.com/cellwebb/gac/actions)
-[![codecov](https://codecov.io/gh/cellwebb/gac/branch/main/graph/badge.svg)](https://app.codecov.io/gh/cellwebb/gac)
-[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
-[![mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](https://mypy-lang.org/)
-[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](docs/CONTRIBUTING.md)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-
-## Features
-
-- **LLM-Powered Commit Messages:** Automatically generates clear, concise, and context-aware commit messages using large language models.
-- **Deep Contextual Analysis:** Understands your code by analyzing staged changes, repository structure, and recent commit history to provide highly relevant suggestions.
-- **Multi-Provider & Model Support:** Flexibly works with leading AI providers (Anthropic, Cerebras, Chutes.ai, Gemini, Groq, OpenAI, OpenRouter, Streamlake/Vanchin, Synthetic.new, & Z.AI) and local providers (LM Studio & Ollama), easily configured through an interactive setup or environment variables.
-- **Seamless Git Workflow:** Integrates smoothly into your existing Git routine as a simple drop-in replacement for `git commit`.
-- **Extensive Customization:** Tailor commit messages to your needs with a rich set of flags, including one-liners (`-o`), detailed verbose messages (`-v`), AI hints (`-h`), scope inference (`-s`), and specific model selection (`-m`).
-- **Streamlined Workflow Commands:** Boost your productivity with convenient options to stage all changes (`-a`), auto-confirm commits (`-y`), and push to your remote repository (`-p`) in a single step.
-- **Interactive Reroll with Feedback:** Not satisfied with the generated commit message? Use `r` for a simple regeneration, or `r <feedback>` to provide specific improvement suggestions (e.g., `r make it shorter`, `r focus on the bug fix`).
-- **Token Usage Tracking:** Display token consumption statistics (prompt, completion, and total tokens).
-- **Security Scanner:** Built-in detection of secrets and API keys in staged changes to prevent accidental commits of sensitive information.
-
-## How It Works
-
-gac analyzes your staged changes to generate high-quality commit messages with the help of large language models. The tool uses a sophisticated prompt architecture that separates system instructions from user data, enabling better AI understanding and more consistent results.
-
-## How to Use
-
-```sh
-git add .
-gac
-```
-
-![Simple gac Usage](assets/gac-simple-usage.png)
-
-## Installation and Configuration
-
-### 1. Installation
-
-#### Quick Try with uvx (no installation)
-
-You can try gac without installing it using uvx:
-
-```sh
-# Try gac without installation
-uvx gac --help
-
-# Set up configuration (creates ~/.gac.env)
-uvx gac init
-
-# Use gac on staged changes
-git add .
-uvx gac
-```
-
-#### Permanent Installation
-
-Install system-wide using pipx from the GitHub repository:
-
-```sh
-# Install pipx if you don't have it
-python3 -m pip install --user pipx
-python3 -m pipx ensurepath
-
-# Install gac
-pipx install gac
-```
-
-Verify installation:
-
-```sh
-gac --version
-```
-
-### 2. Configuration
-
-The recommended way to configure `gac` is using the interactive setup:
-
-```sh
-gac init
-```
-
-This command will guide you through selecting an AI provider, model, and securely entering your API keys. It will create or update a user-level configuration file at `$HOME/.gac.env`.
-
-Example `$HOME/.gac.env` output:
-
-```env
-GAC_MODEL=anthropic:claude-3-5-haiku-latest
-ANTHROPIC_API_KEY=your_anthropic_key_here
-```
-
-Alternatively, you can configure `gac` using environment variables or by manually creating/editing the configuration file.
-
-#### Managing Configuration with `gac config`
-
-You can manage settings in your `$HOME/.gac.env` file using `gac config` commands:
-
-- Streamlake uses inference endpoint IDs instead of model names. When prompted, paste the exact endpoint ID from the Streamlake console.
-- For local providers like Ollama and LM Studio, gac will ask for the base API URL. API keys are optional for these providers unless your instance requires authentication.
-
-- Show config: `gac config show`
-- Set a value: `gac config set GAC_MODEL groq:meta-llama/llama-4-scout-17b-16e-instruct`
-- Get a value: `gac config get GAC_MODEL`
-- Unset a value: `gac config unset GAC_MODEL`
-
-### 3. Verify Setup
-
-Test that `gac` is working properly with your configuration:
-
-```sh
-# Make a change to a file
-echo "# Test change" >> README.md
-git add README.md
-gac -o # Generate a one-line commit message
-```
-
-You should see an AI-generated commit message.
-
-### 4. Upgrade
-
-To upgrade `gac` to the latest version, run:
-
-```sh
-pipx upgrade gac
-```
-
-## Basic Usage
-
-Once installed and configured, using `gac` is straightforward:
-
-1. Stage your changes:
-
-   ```sh
-   git add .
-   ```
-
-2. Run `gac`:
-
-   ```sh
-   gac
-   ```
-
-   This will generate a commit message for review. Confirm with `y` to accept the message.
-
-### Common Commands
-
-- Generate a commit message: `gac`
-- Auto-accept the commit message: `gac -y`
-- Stage all changes and generate a commit message: `gac -a`
-- Generate a one-line commit message: `gac -o`
-- Add a hint for the AI: `gac -h "Fixed the authentication bug"`
-- Push the commit (requires accepting the commit message): `gac -p`
-- Advanced usage: Add all, auto-confirm, push a one-liner with a hint: `gac -aypo -h "update for release"`
-- Skip security scan: `gac --skip-secret-scan` (use with caution)
-
-### Security Features
-
-GAC includes a built-in security scanner to prevent accidental commits of sensitive information:
-
-- **Automatic Scanning**: By default, scans all staged changes for potential secrets and API keys
-- **Interactive Protection**: When secrets are detected, you can:
-  - Abort the commit (recommended)
-  - Continue anyway (not recommended)
-  - Remove affected files and continue
-- **Wide Coverage**: Detects AWS keys, GitHub tokens, OpenAI API keys, database URLs, private keys, and more
-- **Smart Filtering**: Ignores example keys, placeholders, and test values to reduce false positives
-
-To disable the security scan (not recommended unless you know what you're doing):
-
-```sh
-# Skip scan for one command
-gac --skip-secret-scan
-
-# Or disable via environment variable
-export GAC_SKIP_SECRET_SCAN=true
-gac
-```
-
-For a full list of CLI flags, advanced options, and example workflows, see [USAGE.md](USAGE.md).
-
-## Best Practices
-
-- gac loads configuration from two locations (in order of precedence):
-  1. User-level `$HOME/.gac.env` (applies to all projects for the user)
-  2. Project-level `.env` (in the project root, overrides user config if present) Environment variables always take final precedence over both files.
-- Keep API keys out of version control
-- For troubleshooting, see [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
-
-## Contributing
-
-We welcome contributions! Please see [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for guidelines.
-
-## License
-
-This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.
-
-## Community & Support
-
-For questions, suggestions, or support, please open an issue or discussion on GitHub.

gac-1.9.4/README.md

@@ -1,202 +0,0 @@
-<!-- markdownlint-disable MD013 -->
-
-# Git Auto Commit (gac)
-
-[![PyPI version](https://img.shields.io/pypi/v/gac.svg)](https://pypi.org/project/gac/)
-[![Python](https://img.shields.io/badge/python-3.10%20|%203.11%20|%203.12%20|%203.13%20|%203.14-blue.svg)](https://www.python.org/downloads/)
-[![Build Status](https://github.com/cellwebb/gac/actions/workflows/ci.yml/badge.svg)](https://github.com/cellwebb/gac/actions)
-[![codecov](https://codecov.io/gh/cellwebb/gac/branch/main/graph/badge.svg)](https://app.codecov.io/gh/cellwebb/gac)
-[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
-[![mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](https://mypy-lang.org/)
-[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](docs/CONTRIBUTING.md)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-
-## Features
-
-- **LLM-Powered Commit Messages:** Automatically generates clear, concise, and context-aware commit messages using large language models.
-- **Deep Contextual Analysis:** Understands your code by analyzing staged changes, repository structure, and recent commit history to provide highly relevant suggestions.
-- **Multi-Provider & Model Support:** Flexibly works with leading AI providers (Anthropic, Cerebras, Chutes.ai, Gemini, Groq, OpenAI, OpenRouter, Streamlake/Vanchin, Synthetic.new, & Z.AI) and local providers (LM Studio & Ollama), easily configured through an interactive setup or environment variables.
-- **Seamless Git Workflow:** Integrates smoothly into your existing Git routine as a simple drop-in replacement for `git commit`.
-- **Extensive Customization:** Tailor commit messages to your needs with a rich set of flags, including one-liners (`-o`), detailed verbose messages (`-v`), AI hints (`-h`), scope inference (`-s`), and specific model selection (`-m`).
-- **Streamlined Workflow Commands:** Boost your productivity with convenient options to stage all changes (`-a`), auto-confirm commits (`-y`), and push to your remote repository (`-p`) in a single step.
-- **Interactive Reroll with Feedback:** Not satisfied with the generated commit message? Use `r` for a simple regeneration, or `r <feedback>` to provide specific improvement suggestions (e.g., `r make it shorter`, `r focus on the bug fix`).
-- **Token Usage Tracking:** Display token consumption statistics (prompt, completion, and total tokens).
-- **Security Scanner:** Built-in detection of secrets and API keys in staged changes to prevent accidental commits of sensitive information.
-
-## How It Works
-
-gac analyzes your staged changes to generate high-quality commit messages with the help of large language models. The tool uses a sophisticated prompt architecture that separates system instructions from user data, enabling better AI understanding and more consistent results.
-
-## How to Use
-
-```sh
-git add .
-gac
-```
-
-![Simple gac Usage](assets/gac-simple-usage.png)
-
-## Installation and Configuration
-
-### 1. Installation
-
-#### Quick Try with uvx (no installation)
-
-You can try gac without installing it using uvx:
-
-```sh
-# Try gac without installation
-uvx gac --help
-
-# Set up configuration (creates ~/.gac.env)
-uvx gac init
-
-# Use gac on staged changes
-git add .
-uvx gac
-```
-
-#### Permanent Installation
-
-Install system-wide using pipx from the GitHub repository:
-
-```sh
-# Install pipx if you don't have it
-python3 -m pip install --user pipx
-python3 -m pipx ensurepath
-
-# Install gac
-pipx install gac
-```
-
-Verify installation:
-
-```sh
-gac --version
-```
-
-### 2. Configuration
-
-The recommended way to configure `gac` is using the interactive setup:
-
-```sh
-gac init
-```
-
-This command will guide you through selecting an AI provider, model, and securely entering your API keys. It will create or update a user-level configuration file at `$HOME/.gac.env`.
-
-Example `$HOME/.gac.env` output:
-
-```env
-GAC_MODEL=anthropic:claude-3-5-haiku-latest
-ANTHROPIC_API_KEY=your_anthropic_key_here
-```
-
-Alternatively, you can configure `gac` using environment variables or by manually creating/editing the configuration file.
-
-#### Managing Configuration with `gac config`
-
-You can manage settings in your `$HOME/.gac.env` file using `gac config` commands:
-
-- Streamlake uses inference endpoint IDs instead of model names. When prompted, paste the exact endpoint ID from the Streamlake console.
-- For local providers like Ollama and LM Studio, gac will ask for the base API URL. API keys are optional for these providers unless your instance requires authentication.
-
-- Show config: `gac config show`
-- Set a value: `gac config set GAC_MODEL groq:meta-llama/llama-4-scout-17b-16e-instruct`
-- Get a value: `gac config get GAC_MODEL`
-- Unset a value: `gac config unset GAC_MODEL`
-
-### 3. Verify Setup
-
-Test that `gac` is working properly with your configuration:
-
-```sh
-# Make a change to a file
-echo "# Test change" >> README.md
-git add README.md
-gac -o # Generate a one-line commit message
-```
-
-You should see an AI-generated commit message.
-
-### 4. Upgrade
-
-To upgrade `gac` to the latest version, run:
-
-```sh
-pipx upgrade gac
-```
-
-## Basic Usage
-
-Once installed and configured, using `gac` is straightforward:
-
-1. Stage your changes:
-
-   ```sh
-   git add .
-   ```
-
-2. Run `gac`:
-
-   ```sh
-   gac
-   ```
-
-   This will generate a commit message for review. Confirm with `y` to accept the message.
-
-### Common Commands
-
-- Generate a commit message: `gac`
-- Auto-accept the commit message: `gac -y`
-- Stage all changes and generate a commit message: `gac -a`
-- Generate a one-line commit message: `gac -o`
-- Add a hint for the AI: `gac -h "Fixed the authentication bug"`
-- Push the commit (requires accepting the commit message): `gac -p`
-- Advanced usage: Add all, auto-confirm, push a one-liner with a hint: `gac -aypo -h "update for release"`
-- Skip security scan: `gac --skip-secret-scan` (use with caution)
-
-### Security Features
-
-GAC includes a built-in security scanner to prevent accidental commits of sensitive information:
-
-- **Automatic Scanning**: By default, scans all staged changes for potential secrets and API keys
-- **Interactive Protection**: When secrets are detected, you can:
-  - Abort the commit (recommended)
-  - Continue anyway (not recommended)
-  - Remove affected files and continue
-- **Wide Coverage**: Detects AWS keys, GitHub tokens, OpenAI API keys, database URLs, private keys, and more
-- **Smart Filtering**: Ignores example keys, placeholders, and test values to reduce false positives
-
-To disable the security scan (not recommended unless you know what you're doing):
-
-```sh
-# Skip scan for one command
-gac --skip-secret-scan
-
-# Or disable via environment variable
-export GAC_SKIP_SECRET_SCAN=true
-gac
-```
-
-For a full list of CLI flags, advanced options, and example workflows, see [USAGE.md](USAGE.md).
-
-## Best Practices
-
-- gac loads configuration from two locations (in order of precedence):
-  1. User-level `$HOME/.gac.env` (applies to all projects for the user)
-  2. Project-level `.env` (in the project root, overrides user config if present) Environment variables always take final precedence over both files.
-- Keep API keys out of version control
-- For troubleshooting, see [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
-
-## Contributing
-
-We welcome contributions! Please see [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for guidelines.
-
-## License
-
-This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.
-
-## Community & Support
-
-For questions, suggestions, or support, please open an issue or discussion on GitHub.