Metadata-Version: 2.4
Name: gitmate_benjamin
Version: 0.1.0
Summary: A terminal-based Git assistant
Project-URL: Homepage, https://github.com/JohnEdwinR/gitmate
Project-URL: Repository, https://github.com/JohnEdwinR/gitmate
Project-URL: Issues, https://github.com/JohnEdwinR/gitmate/issues
Author: John Rajaratnam
License-Expression: MIT
Keywords: assistant,cli,developer-tools,git,terminal
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.10
Requires-Dist: questionary>=2
Requires-Dist: rich>=13
Requires-Dist: typer[all]>=0.12
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: pytest-mock>=3; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Description-Content-Type: text/markdown

# GitMate

A terminal-based Git assistant that helps users choose, understand, and safely run the correct Git commands.

GitMate inspects the current repository's state and guides the user through common Git workflows using plain language, categories, and safe command previews — instead of requiring them to memorize Git commands.

See [`gitmate/docs/gitmate-tool-concept.md`](gitmate/docs/gitmate-tool-concept.md) for the full concept, architecture, safety model, and roadmap.

## Status

**MVP complete** (Phases 1-4). All 20 workflows implemented with repository inspection, guided CLI menus, safety engine, command previews, and confirmation prompts.

## Setup

```bash
python -m venv .venv
.venv\Scripts\Activate.ps1   # Windows PowerShell
pip install -e ".[dev]"
```

## Running

Interactive mode:

```bash
gitmate
```

Direct commands:

```bash
gitmate status
gitmate save
gitmate undo
gitmate branch create feature/login
gitmate branch switch main
gitmate sync push
gitmate sync pull
gitmate commit amend-message
gitmate history
gitmate stash save
gitmate stash restore
gitmate explain "git reset --soft HEAD~1"
gitmate ask "change my last commit message"
```

## Testing

```bash
pytest
```
