gitdude 1.0.0__tar.gz

gitdude-1.0.0/.env.example

@@ -0,0 +1,17 @@
+# GitWise — AI Provider API Keys
+# Copy this file to .env and fill in your keys.
+# NOTE: GitWise does NOT read .env files directly.
+# Keys are stored securely in ~/.gitwise/config.json via `gitwise config`.
+# These are only here as a reference for the key names.
+
+# Google Gemini (default — free at https://aistudio.google.com/app/apikey)
+GEMINI_API_KEY=your-gemini-api-key-here
+
+# Groq (free tier — fastest inference, https://console.groq.com/keys)
+GROQ_API_KEY=your-groq-api-key-here
+
+# OpenAI (optional — https://platform.openai.com/api-keys)
+OPENAI_API_KEY=your-openai-api-key-here
+
+# Ollama: no API key needed — fully local
+# Make sure Ollama is running: https://ollama.ai

gitdude-1.0.0/.gitignore

@@ -0,0 +1 @@
+dist

gitdude-1.0.0/PKG-INFO

@@ -0,0 +1,305 @@
+Metadata-Version: 2.4
+Name: gitdude
+Version: 1.0.0
+Summary: AI-powered Git workflow assistant — commit, review, recover, and more with a single command
+Project-URL: Homepage, https://github.com/utkarshgupta188/gitdude
+Project-URL: Repository, https://github.com/utkarshgupta188/gitdude
+Project-URL: Documentation, https://github.com/utkarshgupta188/gitdude#readme
+Project-URL: Bug Tracker, https://github.com/utkarshgupta188/gitdude/issues
+Author: GitDude Contributors
+License: MIT
+Keywords: ai,cli,developer-tools,gemini,git,groq,ollama,openai
+Classifier: Development Status :: 4 - Beta
+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 :: Version Control :: Git
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: gitpython>=3.1.40
+Requires-Dist: google-generativeai>=0.7.0
+Requires-Dist: groq>=0.9.0
+Requires-Dist: ollama>=0.2.0
+Requires-Dist: openai>=1.30.0
+Requires-Dist: pyperclip>=1.8.2
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer[all]>=0.12.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# GitDude 🧠
+
+[![PyPI version](https://img.shields.io/pypi/v/gitwise.svg)](https://pypi.org/project/gitwise/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://img.shields.io/pypi/dm/gitwise)](https://pypi.org/project/gitwise/)
+
+**GitDude is an AI-powered Git workflow assistant that turns plain English into git actions — commit, review, recover, and understand your repo from the terminal.**
+
+---
+
+## ✨ Features
+
+- 🤖 **Multi-provider AI** — Gemini (default, free), Groq (fastest), Ollama (100% local), OpenAI
+- 💬 **Natural language commands** — `gitwise do "stash, switch to main, pull"`
+- 🔍 **AI code review** — bugs, security issues, quality flags before you push
+- 🚑 **Emergency recovery** — `gitwise whoops` diagnoses and fixes git disasters
+- 📋 **PR generation** — full GitHub PR description, auto-copied to clipboard
+- 🎨 **Beautiful Rich UI** — tables, panels, spinners, color-coded output
+- 🔐 **Secure config** — keys stored in `~/.gitdude/config.json`, never in `.env`
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# 1. Install
+pip install gitdude
+
+# 2. Configure (takes 60 seconds)
+gitwise config
+
+# 3. Generate an AI commit message and push
+gitwise push
+
+# 4. Review your code before merging
+gitwise review
+
+# 5. Something went wrong? Ask for help
+gitwise whoops
+```
+
+---
+
+## 📦 Installation
+
+```bash
+pip install gitdude
+```
+
+**Python 3.10+ required.**
+
+---
+
+## 🔑 Provider Setup
+
+### Google Gemini (Default — Free)
+
+1. Get an API key from [Google AI Studio](https://aistudio.google.com/app/apikey)
+2. Run `gitwise config` → choose `gemini` → paste key
+
+### Groq (Fastest Free Tier)
+
+1. Get a key at [console.groq.com/keys](https://console.groq.com/keys)
+2. Run `gitwise config` → choose `groq` → paste key
+
+### Ollama (100% Local/Offline)
+
+1. Install Ollama: [ollama.ai](https://ollama.ai)
+2. Pull a model: `ollama pull llama3`
+3. Run `gitwise config` → choose `ollama` (no key needed)
+
+### OpenAI
+
+1. Get a key at [platform.openai.com](https://platform.openai.com/api-keys)
+2. Run `gitwise config` → choose `openai` → paste key
+
+---
+
+## 📖 Command Reference
+
+### `gitwise push`
+
+AI-generates a commit message for your changes, lets you confirm/edit, then commits and pushes.
+
+```bash
+gitwise push                      # Stage all → AI commit → push
+gitwise push --no-confirm         # Skip confirmation
+gitwise push --dry-run            # Preview only, don't execute
+gitwise push --style freeform     # Use freeform (not conventional) commit style
+```
+
+**Commit types (conventional):** `feat`, `fix`, `chore`, `docs`, `refactor`, `style`, `test`, `perf`, `ci`
+
+---
+
+### `gitwise sync`
+
+Fetch + rebase. If there are merge conflicts, AI explains what's conflicting and gives exact resolution steps.
+
+```bash
+gitwise sync
+gitwise sync --dry-run
+```
+
+---
+
+### `gitwise back`
+
+Shows last 30 commits in a table. Pick one to go back to, choose a mode.
+
+```bash
+gitwise back
+gitwise back --dry-run
+```
+
+**Modes:** `soft` (keep changes staged), `hard` (discard changes), `checkout` (detached HEAD), `branch` (new branch from that commit)
+
+---
+
+### `gitwise undo "<description>"`
+
+Describe what went wrong — AI reads your log and reflog to determine the safest recovery.
+
+```bash
+gitwise undo "I accidentally committed my .env file"
+gitwise undo "I deleted the wrong branch"
+gitwise undo "I made a mess of the last 3 commits" --dry-run
+```
+
+---
+
+### `gitwise do "<natural language>"`
+
+Convert plain English into a sequence of git commands, preview, then execute.
+
+```bash
+gitwise do "stash my changes, switch to main, pull latest"
+gitwise do "create a new branch called feature/auth and push it"
+gitwise do "squash my last 3 commits" --dry-run
+```
+
+If any command fails, AI reads the error and suggests a fix.
+
+---
+
+### `gitwise review`
+
+Diffs your current branch vs main/master, then AI reviews for bugs, security issues, and quality.
+
+```bash
+gitwise review
+gitwise review --base develop     # Compare against a different branch
+gitwise review --dry-run          # Show diff without AI review
+```
+
+**Review sections:** Summary · ⚠️ Potential Bugs · 🔒 Security Issues · 📏 Code Quality · 🔍 Things to Check · ✅ Overall Assessment
+
+---
+
+### `gitwise pr`
+
+Generates a complete PR title + description + bullet list + testing notes. Auto-copies to clipboard.
+
+```bash
+gitwise pr
+gitwise pr --base develop         # Compare against develop
+gitwise pr --no-copy              # Don't copy to clipboard
+```
+
+---
+
+### `gitwise explain`
+
+Reads your last 5 reflog entries and explains in plain English what happened.
+
+```bash
+gitwise explain
+```
+
+---
+
+### `gitwise whoops`
+
+Emergency recovery. Feeds git status + log + reflog to AI. Diagnoses what went wrong and gives step-by-step recovery.
+
+```bash
+gitwise whoops
+gitwise whoops --dry-run          # Diagnose only, don't execute
+```
+
+---
+
+### `gitwise config`
+
+Interactive configuration wizard.
+
+```bash
+gitwise config                    # Run setup
+gitwise config --show             # Print current config (keys masked)
+gitwise config --reset            # Wipe config and redo setup
+```
+
+**Stored settings:**
+- AI provider (`gemini` / `groq` / `ollama` / `openai`)
+- API key per provider
+- Model name per provider
+- Default branch (`main` or `master`)
+- Commit style (`conventional` or `freeform`)
+
+---
+
+## 🏗️ Architecture
+
+```
+gitwise/
+├── main.py        # Typer app — all command definitions
+├── ai.py          # Unified AI provider wrapper (ask_ai)
+├── git_ops.py     # GitPython operations (diff, log, push, reset…)
+├── config.py      # Config at ~/.gitdude/config.json
+└── utils.py       # Rich panels, tables, prompts, helpers
+```
+
+**AI Providers (`ai.py`):**
+
+| Provider | SDK | Default Model | Speed | Cost |
+|---|---|---|---|---|
+| `gemini` | `google-generativeai` | `gemini-2.0-flash` | Fast | Free tier |
+| `groq` | `groq` | `llama-3.3-70b-versatile` | Fastest | Free tier |
+| `ollama` | `ollama` | `llama3` | Local | Free (local) |
+| `openai` | `openai` | `gpt-4o-mini` | Fast | Pay per use |
+
+All providers go through a single interface: `ask_ai(prompt) -> str` with spinner feedback and unified error handling.
+
+---
+
+## 🛡️ Safety Features
+
+- ✅ **All destructive operations** (hard reset, force push, etc.) require explicit confirmation
+- ✅ **`--dry-run` flag** available on all mutating commands
+- ✅ **Color-coded risk levels** — green (safe), yellow (caution), red (destructive)
+- ✅ **No tracebacks** — all exceptions caught and shown as friendly Rich error panels
+- ✅ **API keys** stored privately in `~/.gitdude/config.json`, never in project files
+
+---
+
+## 🤝 Contributing
+
+1. Fork the repo
+2. Create a feature branch: `git checkout -b feat/amazing-feature`
+3. Make your changes
+4. Run linting: `ruff check .`
+5. Open a PR — or just use `gitwise pr` to generate your PR description! 😄
+
+**Dev setup:**
+```bash
+git clone https://github.com/gitwise/gitwise
+cd gitwise
+pip install -e ".[dev]"
+```
+
+---
+
+## 📄 License
+
+MIT © GitWise Contributors

gitdude-1.0.0/README.md

@@ -0,0 +1,266 @@
+# GitDude 🧠
+
+[![PyPI version](https://img.shields.io/pypi/v/gitwise.svg)](https://pypi.org/project/gitwise/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://img.shields.io/pypi/dm/gitwise)](https://pypi.org/project/gitwise/)
+
+**GitDude is an AI-powered Git workflow assistant that turns plain English into git actions — commit, review, recover, and understand your repo from the terminal.**
+
+---
+
+## ✨ Features
+
+- 🤖 **Multi-provider AI** — Gemini (default, free), Groq (fastest), Ollama (100% local), OpenAI
+- 💬 **Natural language commands** — `gitwise do "stash, switch to main, pull"`
+- 🔍 **AI code review** — bugs, security issues, quality flags before you push
+- 🚑 **Emergency recovery** — `gitwise whoops` diagnoses and fixes git disasters
+- 📋 **PR generation** — full GitHub PR description, auto-copied to clipboard
+- 🎨 **Beautiful Rich UI** — tables, panels, spinners, color-coded output
+- 🔐 **Secure config** — keys stored in `~/.gitdude/config.json`, never in `.env`
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# 1. Install
+pip install gitdude
+
+# 2. Configure (takes 60 seconds)
+gitwise config
+
+# 3. Generate an AI commit message and push
+gitwise push
+
+# 4. Review your code before merging
+gitwise review
+
+# 5. Something went wrong? Ask for help
+gitwise whoops
+```
+
+---
+
+## 📦 Installation
+
+```bash
+pip install gitdude
+```
+
+**Python 3.10+ required.**
+
+---
+
+## 🔑 Provider Setup
+
+### Google Gemini (Default — Free)
+
+1. Get an API key from [Google AI Studio](https://aistudio.google.com/app/apikey)
+2. Run `gitwise config` → choose `gemini` → paste key
+
+### Groq (Fastest Free Tier)
+
+1. Get a key at [console.groq.com/keys](https://console.groq.com/keys)
+2. Run `gitwise config` → choose `groq` → paste key
+
+### Ollama (100% Local/Offline)
+
+1. Install Ollama: [ollama.ai](https://ollama.ai)
+2. Pull a model: `ollama pull llama3`
+3. Run `gitwise config` → choose `ollama` (no key needed)
+
+### OpenAI
+
+1. Get a key at [platform.openai.com](https://platform.openai.com/api-keys)
+2. Run `gitwise config` → choose `openai` → paste key
+
+---
+
+## 📖 Command Reference
+
+### `gitwise push`
+
+AI-generates a commit message for your changes, lets you confirm/edit, then commits and pushes.
+
+```bash
+gitwise push                      # Stage all → AI commit → push
+gitwise push --no-confirm         # Skip confirmation
+gitwise push --dry-run            # Preview only, don't execute
+gitwise push --style freeform     # Use freeform (not conventional) commit style
+```
+
+**Commit types (conventional):** `feat`, `fix`, `chore`, `docs`, `refactor`, `style`, `test`, `perf`, `ci`
+
+---
+
+### `gitwise sync`
+
+Fetch + rebase. If there are merge conflicts, AI explains what's conflicting and gives exact resolution steps.
+
+```bash
+gitwise sync
+gitwise sync --dry-run
+```
+
+---
+
+### `gitwise back`
+
+Shows last 30 commits in a table. Pick one to go back to, choose a mode.
+
+```bash
+gitwise back
+gitwise back --dry-run
+```
+
+**Modes:** `soft` (keep changes staged), `hard` (discard changes), `checkout` (detached HEAD), `branch` (new branch from that commit)
+
+---
+
+### `gitwise undo "<description>"`
+
+Describe what went wrong — AI reads your log and reflog to determine the safest recovery.
+
+```bash
+gitwise undo "I accidentally committed my .env file"
+gitwise undo "I deleted the wrong branch"
+gitwise undo "I made a mess of the last 3 commits" --dry-run
+```
+
+---
+
+### `gitwise do "<natural language>"`
+
+Convert plain English into a sequence of git commands, preview, then execute.
+
+```bash
+gitwise do "stash my changes, switch to main, pull latest"
+gitwise do "create a new branch called feature/auth and push it"
+gitwise do "squash my last 3 commits" --dry-run
+```
+
+If any command fails, AI reads the error and suggests a fix.
+
+---
+
+### `gitwise review`
+
+Diffs your current branch vs main/master, then AI reviews for bugs, security issues, and quality.
+
+```bash
+gitwise review
+gitwise review --base develop     # Compare against a different branch
+gitwise review --dry-run          # Show diff without AI review
+```
+
+**Review sections:** Summary · ⚠️ Potential Bugs · 🔒 Security Issues · 📏 Code Quality · 🔍 Things to Check · ✅ Overall Assessment
+
+---
+
+### `gitwise pr`
+
+Generates a complete PR title + description + bullet list + testing notes. Auto-copies to clipboard.
+
+```bash
+gitwise pr
+gitwise pr --base develop         # Compare against develop
+gitwise pr --no-copy              # Don't copy to clipboard
+```
+
+---
+
+### `gitwise explain`
+
+Reads your last 5 reflog entries and explains in plain English what happened.
+
+```bash
+gitwise explain
+```
+
+---
+
+### `gitwise whoops`
+
+Emergency recovery. Feeds git status + log + reflog to AI. Diagnoses what went wrong and gives step-by-step recovery.
+
+```bash
+gitwise whoops
+gitwise whoops --dry-run          # Diagnose only, don't execute
+```
+
+---
+
+### `gitwise config`
+
+Interactive configuration wizard.
+
+```bash
+gitwise config                    # Run setup
+gitwise config --show             # Print current config (keys masked)
+gitwise config --reset            # Wipe config and redo setup
+```
+
+**Stored settings:**
+- AI provider (`gemini` / `groq` / `ollama` / `openai`)
+- API key per provider
+- Model name per provider
+- Default branch (`main` or `master`)
+- Commit style (`conventional` or `freeform`)
+
+---
+
+## 🏗️ Architecture
+
+```
+gitwise/
+├── main.py        # Typer app — all command definitions
+├── ai.py          # Unified AI provider wrapper (ask_ai)
+├── git_ops.py     # GitPython operations (diff, log, push, reset…)
+├── config.py      # Config at ~/.gitdude/config.json
+└── utils.py       # Rich panels, tables, prompts, helpers
+```
+
+**AI Providers (`ai.py`):**
+
+| Provider | SDK | Default Model | Speed | Cost |
+|---|---|---|---|---|
+| `gemini` | `google-generativeai` | `gemini-2.0-flash` | Fast | Free tier |
+| `groq` | `groq` | `llama-3.3-70b-versatile` | Fastest | Free tier |
+| `ollama` | `ollama` | `llama3` | Local | Free (local) |
+| `openai` | `openai` | `gpt-4o-mini` | Fast | Pay per use |
+
+All providers go through a single interface: `ask_ai(prompt) -> str` with spinner feedback and unified error handling.
+
+---
+
+## 🛡️ Safety Features
+
+- ✅ **All destructive operations** (hard reset, force push, etc.) require explicit confirmation
+- ✅ **`--dry-run` flag** available on all mutating commands
+- ✅ **Color-coded risk levels** — green (safe), yellow (caution), red (destructive)
+- ✅ **No tracebacks** — all exceptions caught and shown as friendly Rich error panels
+- ✅ **API keys** stored privately in `~/.gitdude/config.json`, never in project files
+
+---
+
+## 🤝 Contributing
+
+1. Fork the repo
+2. Create a feature branch: `git checkout -b feat/amazing-feature`
+3. Make your changes
+4. Run linting: `ruff check .`
+5. Open a PR — or just use `gitwise pr` to generate your PR description! 😄
+
+**Dev setup:**
+```bash
+git clone https://github.com/gitwise/gitwise
+cd gitwise
+pip install -e ".[dev]"
+```
+
+---
+
+## 📄 License
+
+MIT © GitWise Contributors

gitdude-1.0.0/gitwise/__init__.py

@@ -0,0 +1,5 @@
+"""GitDude — AI-powered Git workflow assistant."""
+
+__version__ = "1.0.0"
+__author__ = "GitDude Contributors"
+__license__ = "MIT"