Metadata-Version: 2.4
Name: gitassist
Version: 0.1.0
Summary: AI-powered Git commit message helper
Author-email: Vijay Bala <contact@vijaybala.com>
License: MIT
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: click
Requires-Dist: openai
Requires-Dist: gitpython

GitAssist README
# GitAssist
GitAssist is a command-line tool that uses OpenAI to generate commit messages and pull
request descriptions based on your Git history and staged changes. It streamlines your Git
workflow by suggesting clear, concise, and contextually appropriate messages.
## Features
- Automatically generate commit messages from staged changes
- Automatically generate PR titles and descriptions from commit history
- Push the current branch and open the PR creation page on GitHub or GitLab
## Installation
Clone the repository and install the CLI tool in editable mode:
```bash
pip install --editable .
```
## Usage
### Initialize the tool with your OpenAI API key:
```bash
GitAssist init
```
GitAssist README
### Generate and commit with an AI-suggested message:
```bash
GitAssist commit
```
### Generate a PR title and description, push your branch, and open the PR page:
```bash
GitAssist new-pr --base main
```
## Requirements
- Python 3.7+
- `git` must be installed and available on your system path
- A valid OpenAI API key
## Assumptions
GitAssist assumes a few things about your development workflow:
1. **Branching Model**: You are working on a feature branch that diverged from a long-lived
base branch like `main`.
2. **Staging Area**: When running `GitAssist commit`, you have already staged your changes.
3. **Remote Setup**: You have a remote named `origin` pointing to a GitHub or GitLab
repository.
GitAssist README
4. **Authentication**: You are authenticated with the remote (e.g., via SSH or HTTPS
credentials) and have permission to push.
5. **Push Before PR**: Your local branch does not need to be pushed manually before PR
creation — GitAssist pushes it for you.
6. **Platform Detection**: GitAssist can detect whether you're using GitHub or GitLab based
on your `origin` URL.
## License
MIT License
