Skip to content

Srikarmk/Gitgotchi

Repository files navigation

🎃 GitGotchi - Your Friendly Dev Companion 👻

A Stardew Valley X Halloween -inspired terminal companion that lives in your git repository!

✨ Features

  • Adorable pixel art companion that evolves based on your coding habits
  • Warm, encouraging stories about your code history
  • Automatic feeding through git hooks
  • Friendship system inspired by Stardew Valley
  • Cozy terminal UI with sparkles and hearts
  • Fast evolution - see changes every 2-3 commits!

🚀 Quick Start

pip install -r requirements.txt
python gitgotchi.py install  # Install git hooks
python gitgotchi.py status   # Meet your companion!

🎮 Commands

  • gitgotchi status - See your companion
  • gitgotchi pet - Give them affection
  • gitgotchi story - Hear a code story
  • gitgotchi evolve - Check evolution progress
  • gitgotchi name <name> - Give your companion a name

🌟 Evolution Forms (Fast Track!)

  • 🥚 Egg (0-2 commits)
  • 👻 Ghost (3-5 commits)
  • 👼 Angel (6+ commits, high quality)
  • 😈 Demon (6+ commits, chaotic)
  • 🧟 Zombie (4+ reverts, needs coffee)
  • 🌙 Wraith (15+ commits, ultimate form)

🎨 Theme

GitGotchi is inspired by Stardew Valley's cozy, friendly aesthetic. Your companion is a warm, magical spirit - not scary! Think Junimos, sparkles, and autumn leaves.

Built with ❤️ for Kiroween Hackathon 2024

About

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages