Metadata-Version: 2.4
Name: gitgo
Version: 1.0.2
Summary: A safe Git commit, versioning, and push helper with AI-assisted messages
Author: appfeat
License: MIT
Project-URL: Homepage, https://github.com/appfeat/gitgo
Project-URL: Repository, https://github.com/appfeat/gitgo
Project-URL: Issues, https://github.com/appfeat/gitgo/issues
Keywords: git,cli,commit,versioning,ai
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# 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 git@github.com: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
