A Stardew Valley X Halloween -inspired terminal companion that lives in your git repository!
- 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!
pip install -r requirements.txt
python gitgotchi.py install # Install git hooks
python gitgotchi.py status # Meet your companion!gitgotchi status- See your companiongitgotchi pet- Give them affectiongitgotchi story- Hear a code storygitgotchi evolve- Check evolution progressgitgotchi name <name>- Give your companion a name
- 🥚 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)
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