Skip to content

A Python CLI script that automates Git add, commit, and push actions with optional AI-generated commit messages using Ollama.

License

Notifications You must be signed in to change notification settings

beecave-homelab/git-acp

Repository files navigation

git-acp

A Python tool to automate Git add, commit, and push actions with optional AI-generated commit messages using Ollama. Features a beautiful CLI interface with color-coded output and progress indicators.

GIT-ACP logo

Python Version License

Table of Contents

Features

  • Single-command Git workflow automation
  • AI-powered commit messages via Ollama
  • Interactive file selection and type suggestions
  • Conventional commits with emoji support
  • Color-coded terminal interface
  • Configurable through CLI options and environment variables

Installation

Recommended: Global Installation with pipx

pipx install "git+https://github.com/beecave-homelab/git-acp.git"

For other installation methods and detailed instructions, see the Installation Guide.

Quick Start

# Interactive mode
git-acp

# Commit specific files with message
git-acp -a "README.md src/*.py" -m "Update documentation"

# AI-generated commit message
git-acp -o

git-acp interactive mode

For more usage examples and advanced features, refer to:

Configuration

Configure settings by copying the provided example file and adjusting values:

mkdir -p ~/.config/git-acp
cp .env.example ~/.config/git-acp/.env
nano ~/.config/git-acp/.env  # Adjust values as needed

Example configuration (~/.config/git-acp/.env):

# Example configuration
GIT_ACP_AI_MODEL=mevatron/diffsense:1.5b
GIT_ACP_DEFAULT_BRANCH=main

See Advanced Usage for all available options.

Documentation

License

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

About

A Python CLI script that automates Git add, commit, and push actions with optional AI-generated commit messages using Ollama.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages