Metadata-Version: 2.4
Name: gicom
Version: 0.2.1
Summary: AI-powered Git commit messages generated directly from your terminal.
Home-page: https://github.com/amintorabi88/gicom
Author: Amin Torabi
License: MIT
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9
Requires-Dist: rich>=13
Requires-Dist: openai>=1.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pyperclip
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary


# Gicom 

**AI-powered Git commit messages generated directly from your terminal.**

> Stop writing "fixed stuff" or "wip". Let the ghost in the machine write professional, Conventional Commit messages for you.

## ✨ Features

* **Zero Friction:** One command (`gicom get-ai`) to generate and copy.
* **Professional Format:** Follows [Conventional Commits](https://www.conventionalcommits.org/) (feat:, fix:, chore:).
* **Secure:** Your OpenAI API Key is stored locally in `~/.config/gicom/`.
* **Context Aware:** Analyzes your actual `git diff` to understand what changed.

## 📦 Installation

To install gicom from PyPI:

```bash
pip install gicom

```


## 🚀 Setup

The first time you run gicom, it will prompt you for your OpenAI API key.

1. Get your API key from the [OpenAI Platform](https://platform.openai.com/api-keys).  
   If you see an `insufficient_quota` error, make sure you have added some credit to your account.
   Even $1 is usually enough, since the model used by gicom is very inexpensive.

2. Run the tool:
```bash
gicom get-ai

```

3. Paste your key when prompted (input will be hidden for security).

## 🛠️ Usage

### The Workflow

This is designed for speed. It generates the message and copies it to your clipboard automatically.

1. Stage your changes:
```bash
git add .

```


2. Summon the Ghost:
```bash
gicom get-ai

```


3. **Paste:** Press `Cmd + V` (or `Ctrl + V`) into your commit box (VS Code, GitHub Desktop, or Terminal).

### The "Interactive" Workflow

If you prefer to commit directly from the terminal with a confirmation step:

```bash
gicom commit

```


## 🔒 Security

* Your API Key is stored in `~/.config/gicom/config.json`.
* The file permissions are set to `600` (User Read/Write only).
* Your key is sent only to OpenAI servers for message generation and is never shared elsewhere.

