GitStory

GitStory turns any Git repo into a cinematic narrative. Choose styles like anime, Shakespeare, or voice narration and watch your commit history come alive with personality and storytelling.

Comment

Inspiration

Every repo has a hidden story. Commit logs capture effort, struggle, and breakthroughs — but in a dull, technical format. I wanted to reimagine that history as something human, fun, and expressive. GitStory was born from the idea: what if your codebase could tell its own story?

What it does

GitStory transforms any Git repository into an entertaining narrative. It analyzes commits, extracts milestones, and converts them into cinematic stories, anime-style epics, Shakespearean monologues, or even voice-narrated tales. It makes your code’s journey feel alive and shareable.

How we built it

Built solo using Bun, OpenRouter, and Claude 3.5 Sonnet. The CLI uses Commander, Chalk, and Ora for styling, parses Git commits, applies tailored prompt engineering, and generates narratives. Voice mode launches Web Speech API playback from the terminal. A timeline engine identifies key repo milestones.

Challenges we ran into

  • Crafting prompts that consistently convert commits into readable narrative structures

  • Sending voice narration from CLI → browser seamlessly

  • Keeping LLM inputs efficient for large repos

  • Highlighting meaningful milestones from noisy commit logs

  • Delivering a polished tool within hackathon time constraints

Accomplishments that we're proud of

  • A fully functional storytelling CLI built in a short timeframe

  • Multiple narrative “styles” that genuinely feel different

  • Automatic voice narration triggered directly from terminal

  • A fun, unique way to explore any repository

  • Clean, well-structured Bun project that others can extend

What we learned

  • Advanced prompt engineering for structured storytelling

  • Bun workflow and tooling for rapid project building

  • Creative ways to blend terminal tools with browser APIs

  • Turning raw Git data into something emotional, expressive, and fun

  • How small ideas can become surprisingly delightful dev tools

What's next for GitStory

  • Publish as an npm package

  • Add more storytelling modes and character voices

  • Export stories as videos, audiobooks, or shareable visuals

  • Add richer timeline visualizations

  • Personality-based repo profiles

  • Possibly a web version for non-CLI users

Built With

Share this project:

Updates