GittyCat

GittyCat is a friendly, guided, interactive CLI Git assistant. It simplifies Git workflows by using structured questions and menu-based navigation instead of requiring you to memorize Git commands.

Features ✨

• Interactive Menu: No more guessing commands. Just pick what you want to do from a clean list.
• Guided Workflows: Step-by-step prompts for Committing, Pushing, Pulling, and Branching.
• Beginner Mode 🎓: Toggle this on to get helpful explanations of what each Git action actually does under the hood.
• Safety First 🛡️: Recovery options like Soft and Hard resets with clear, explicit warnings to prevent accidental data loss.
• Fun Personality: A somewhat playful (but professional) cat-themed assistant to brighten your dev day!

Installation 📦

GittyCat requires Node.js (v18+ recommended).

To install globally so you can use it anywhere (run this from inside the GittyCat directory):

npm install -g .

Usage 🚀

Navigate to any of your project directories (Git or non-Git) in your terminal and simply run:

gittycat
# or just the alias
gc

If the folder isn't a Git repository yet, GittyCat will politely ask if you'd like to initialize one!

Example Workflows 📋

The "Commit and Push" Flow:

1. Run gc
2. Select "Commit changes"
3. Review the number of changed files found.
4. Type your concise commit message.
5. Select "Push project" to upload safely to GitHub.

The "Oops" Flow (Undo):

1. Run gc
2. Select "Undo / Recovery"
3. Choose "Undo last commit (Keep files - Soft Reset)" to keep your work but undo the commit itself.

Tech Stack 🛠️

• Node.js
• inquirer: For beautiful, interactive command-line prompts.
• simple-git: For reliable, clean git operations.
• chalk: For adding purr-fect colors to the terminal.
• ora: For elegant loading spinners.
• conf: For remembering your Beginner Mode settings.