gitgo 1.0.2

A safe Git commit, versioning, and push helper with AI-assisted messages

gitgo Release 1.0.2

gitgo is a command-line tool that helps you commit, version, and push Git changes safely, with a clear review step and optional AI-assisted commit messages.

If you often forget to write good commit messages, tag releases consistently, or want a single, predictable command to finalize your work, gup is designed for you.

---

What problem does gup solve?

Many Git workflows break down at the same points:

• changes pile up without commits
• commit messages are rushed or inconsistent
• version tags are forgotten or misnumbered
• pushes happen without a final review

gitgo turns these scattered steps into a single, guided release flow.

---

What gitgo does

When run inside a Git repository, gitgo:

• stages current changes
• proposes a clear commit message (optionally AI-assisted)
• enforces a clean, ≤72-character summary line
• determines the next version tag automatically
• shows a full review screen before committing
• creates the commit and annotated tag
• pushes both to the configured remote

Every step is visible. Nothing happens without confirmation.

---

Why gitgo is different

gup is intentionally conservative.

• No history rewriting
• No hidden automation
• No background hooks
• No silent commits

It favors clarity over cleverness and review over speed.

---

Requirements

• Python 3.9 or newer
• Git
• The llm CLI installed and configured (for AI commit messages)
• A non-bare Git repository

---

Installation

Using pip (recommended)

Install gup as a standard CLI tool:

git clone [e-mail]:appfeat/gitgo.git
cd gitgo 
pip install .

After installation, the gitgo command will be available on your PATH.

---

Usage

From inside a Git repository:

gitgo

OR python -m gitgo

That’s the entire interface.

gitgo will guide you through:

• identity confirmation (if needed)
• model selection (first run only)
• commit message review
• release confirmation

---

Configuration

gitgo stores its settings in Git config:

• gitgo.model – selected LLM model
• gitgo.timeout – AI request timeout (seconds)

These settings are repository-local and do not affect other projects.

---

Typical use cases

• finishing a feature and creating a clean release commit
• maintaining consistent version tags
• solo development with better commit hygiene
• small teams that want predictable Git history

---

Philosophy

gitgo is designed around a simple idea:

Finishing work should feel deliberate, not rushed.

It aims to make the last step of development calm, reviewable, and reliable.

---

License

MIT