GitGenius CLI

Understand Git errors in plain English – directly from your terminal.

📦 Installation

Install GitGenius using:

pip install gitgenius

Or from the local source:

pip install .

🚀 Usage

Basic command:

gitgenius "fatal: not a git repository"

Or run the assistant mode:

gitgenius --admin

✅ Example Output

Explanation: This error means you're trying to run a Git command outside a Git repository.
Solution: Navigate to a folder that is a Git repo, or initialize one with `git init`.

🧪 Run Tests

python3 -m unittest discover tests

💡 Features

• Explains Git errors in simple terms.
• Suggests solutions and fixes.
• CLI and admin assistant modes available.
• Lightweight and beginner-friendly tool.

❓ Why GitGenius?

Git errors can be frustrating, especially for beginners. GitGenius makes it easier to:

• Understand what's wrong.
• Know how to fix it.
• Learn Git through the terminal.

🖥️ Compatibility

• ✅ Windows (CMD/PowerShell) (emoji support optional, see below)
• ✅ Linux
• ✅ macOS

⚠️ Windows CMD Emoji Issue

Windows CMD does not support emojis by default.

💡 Fix Options:

• Use Windows Terminal, PowerShell, or Git Bash.
• Or remove emojis by adding a --no-emoji flag in your tool (recommended feature to add).

📜 License

This project is licensed under the MIT License.

🌟 Star & Contribute

If you find this project helpful, give it a ⭐ on GitHub! Feel free to fork and improve the tool — contributions are welcome.

📫 Contact

Built with ❤️ by Selva Neyas U