🦋 youmna-git (ygit)

The AI-Powered Git Assistant that makes your workflow glide.

youmna-git is a professional-grade CLI tool that transforms your terminal into a smart dashboard. Powered by Google Gemini 3.0, it doesn't just show you your git status—it helps you write code, review bugs, and understand your history.

✨ Features

• 📊 Smart Dashboard: A beautiful, color-coded summary of your branch, changes, and latest commits.
• 🤖 Gemini AI Commit: Instantly generate professional, one-line commit messages by analyzing your file changes.
• 🔍 AI Code Review: Get a senior-level review of your current diff to spot bugs before you push.
• 💬 Repo Chat: Ask questions like "What did I change in the last hour?" and get answers based on your git logs.
• 🛡️ Merge Helper: Solve complex merge conflicts with a step-by-step AI resolution plan.
• ⚡ Lightweight & Fast: Built for speed, keeping your hands on the keyboard.

📦 Installation

Install the tool globally using npm:

npm install -g youmna-git

🦋 youmna-git (ygit)

The AI-Powered Git Assistant that makes your workflow glide.

youmna-git is a professional-grade CLI tool that transforms your terminal into a smart dashboard. Powered by Google Gemini 1.5 Flash, it doesn't just show you your git status—it helps you write code, review bugs, and understand your history.

🔑 Setup

To use the AI features (Commit, Review, Chat), you need to get a free API Key from Google:

1. Get your Key: Go to Google AI Studio and click "Get API key".
2. Add to Environment: Create a file named .env in your project root or add it to your shell profile:

   GEMINI_API_KEY=your_key_here

3. Important: Make sure your .env .npmrc files are added to your .gitignore so your key stays private!

🚀 Usage

Simply type ygit to launch the main dashboard, or use these commands:

⭐ Launch the interactive dashboard

ygit

⭐ Generate an AI commit message for staged changes

ygit commit

⭐ Analyze current code diff for bugs

ygit review

⭐ Ask a question about your history

ygit chat "What features did I add yesterday?"

⭐ Get help resolving active merge conflicts

ygit merge-help

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1- Fork the Project

2- Create your Feature Branch (git checkout -b feature/AmazingFeature)

3- Commit your Changes (git commit -m 'Add some AmazingFeature')

4- Push to the Branch (git push origin feature/AmazingFeature)

5- Open a Pull Request