ace-git-copilot

Ace — AI-Powered Git Copilot

Author: Jachin Samuel jachinsamuel007@gmail.com

 █████╗   ██████╗ ███████╗
██╔══██╗ ██╔════╝ ██╔════╝
███████║ ██║      █████╗  
██╔══██║ ██║      ██╔══╝  
██║  ██║ ╚██████╗ ███████╗
╚═╝  ╚═╝  ╚═════╝ ╚══════╝

Ace is an intelligent command-line copilot that brings AI assistance directly to your Git workflow. Talk to Git in plain English — Ace translates your intents into Git commands, explains what it is doing, and runs them safely. It also features universal Git command pass-through and an interactive terminal dashboard (TUI) to manage your repositories effortlessly.

---

Features

• Universal Git Pass-Through: Run ANY standard Git command or custom Git extension directly through Ace (e.g. ace status, ace log --oneline -n 10, ace checkout -b feature, ace push origin main, ace stash pop).
• Natural Language Git Commands: Translate plain English requests like "undo my last commit but keep changes" or "switch to a new branch called design-updates" into clean, standard Git operations without needing quotes.
• AI-Powered Conventional Commits: Analyzes staged diffs and generates standardized Conventional Commit messages (feat:, fix:, refactor:, docs:, etc.) automatically across both cloud and local offline LLMs.
• Offline Smart Heuristic Fallback: Gracefully degrades to local Ollama or smart heuristic file/diff classification when network connections fail or API endpoints time out.
• Visual Commit Length Gauge: Real-time two-tone progress gauge in commit dialogs enforcing the 50/72 character conventional commit standard.
• Custom Shortcuts & Aliases: Create customized multi-command workflows with ace alias (e.g. ace ship runs git add . && ace commit -y && git push).
• Automated Code Review: Rates code quality on a 10-point scale and identifies bugs, security vulnerabilities, or performance bottlenecks in staged or unstaged diffs.
• Interactive Merge Conflict Resolver: Walks you step-by-step through conflicted files and provides AI-suggested 3-way merged blocks.
• Multi-Language / i18n Output: Localized AI explanations and commit suggestions in 15+ languages (English, Chinese, Spanish, French, German, Japanese, Korean, Hindi, and more).
• Interactive TUI Dashboard (ace dash): Real-time terminal repository browser displaying branch status, commit logs, workspace navigation, and interactive menus.
• Repository Health Doctor (ace doctor): Detects active lock files, detached HEAD states, and oversized untracked files with step-by-step AI recovery guidance.
• AI Git Blame (ace blame): Inspects commit history and diff patches to explain why a specific line of code was written or modified.
• Rich Repo Statistics (ace stats): Visualizes commit frequency charts, top contributors, and repository language/extension breakdowns.
• Automated Release Changelogs (ace changelog): Compiles categorized release changelogs in Markdown since the previous tag.
• Multi-Repo Daily Standups (ace standup): Generates structured summaries of your recent contributions across one or more repositories.
• Smart Git Hooks (ace hook): One-command installation for pre-commit review checks and prepare-commit-msg AI drafting.
• AI Branch Auto-Squashing (ace squash): Automatically analyzes commit histories and guides clean interactive rebases.
• Built-in Safety System: Classifies actions into safe, moderate, and destructive tiers with automatic stashing and interactive confirmation guards.

---

Installation

Option A: Quick 1-Line Installer (Recommended)

Linux & macOS:

curl -fsSL https://raw.githubusercontent.com/jachinsamuel/Ace/master/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/jachinsamuel/Ace/master/install.ps1 | iex

---

Option B: Install via standard pip

pip install ace-git-copilot

# Upgrade to the latest release
pip install --upgrade ace-git-copilot

Note: You can also execute Ace directly through Python module execution:

python -m ace dash

Option C: Install via pipx / uv (Isolated)

# via pipx
pipx install ace-git-copilot

# or via uv
uv tool install ace-git-copilot

---

Configuration and AI Providers

Launch the interactive configuration wizard:

ace setup

Ace stores your configuration at ~/.ace/config.toml. It supports 6 AI model backends:

You can also switch providers directly in the CLI:

ace config

---

Usage Guide

1. Plain-English Natural Language

Speak to Git in plain English directly without quotes:

ace stage everything and commit with a message about authentication
ace undo my last commit but keep the files
ace switch to a new branch called design-updates

2. Custom Shortcuts (ace alias)

Run pre-configured shortcuts or define your own multi-step workflows:

# Run default shortcut (stages, commits with AI, and pushes)
ace ship

# Create custom shortcut
ace alias add deploy "git add . && ace commit -y && git push origin staging"

# List all shortcuts
ace alias list

3. Command-Line Reference

---

Interactive Terminal Dashboard (TUI)

Launch the repository management cockpit:

ace dash

---

Repository Statistics (ace stats)

View visual commit timelines, contributor breakdowns, and file extension distributions:

---

Star History

---

Contributing

Contributions, bug reports, and feature requests are always welcome! Check out our Contributing Guide and Issue Templates to get started.

---

License

Distributed under the MIT License. See LICENSE for more details.