Inspiration 💡
Every hacker has faced this moment: you’ve built something solid, pushed dozens of commits, and when it’s time to explain it—your mind goes blank 😅. Git history is rich, honest, and detailed, but it’s written for machines and future-you, not for demos, READMEs, or judges.
Git Whisper was inspired by that gap. We wanted a tool that could read how a project evolved and translate that history into a clear human story—what problem we were solving, how the solution changed, and what actually matters now.
What it does 🧠
Git Whisper is a local-first CLI tool that turns git commit history into plain-English explanations.
With simple commands, it can:
- Summarize the entire project from commit history
- Explain what changed since the last commit, tag, or release
- Generate a clean changelog
- Produce a ready-to-read 60–90 second demo script
- Explain your most recent work in context
Instead of asking “what does this code do?”, Git Whisper answers
“what story does this repo tell?”
How we built it 🛠️
Git Whisper is built in Rust, focusing on speed, safety, and a clean CLI experience.
- We parse local git history using native git commands
- Commit data is structured and stored as project “memory”
- We curate this history into meaningful context instead of raw logs
- The structured history is sent to an AI model to extract intent, evolution, and impact
- Outputs are returned as clean text suitable for READMEs, demos, and changelogs
Everything works locally—no GitHub auth, no CI setup, no cloud ingestion required 🚀.
Challenges we ran into ⚠️
- Avoiding overanalysis: Reading full code diffs quickly became noisy, so we focused on intent-rich signals like commit messages and summaries.
- Prompt precision: Getting consistent outputs required framing the AI as a technical storyteller, not a code explainer.
- Scope control: It was tempting to add dashboards and visuals, but we stayed disciplined and shipped a strong CLI-first MVP.
Accomplishments that we're proud of 🏆
- A fully working local-first CLI tool built in Rust
- Clear, demo-ready outputs generated purely from git history
- Commands that feel native to hacker workflows
- A project that solves a real pain every developer understands
Most importantly, Git Whisper produces results you can use immediately ✨.
What we learned 📚
- Git history contains far more meaning than we usually extract
- Good tooling is often about translation, not automation
- Constraints (local-only, CLI-only, 2 days) force better product decisions
- Rust is an excellent choice for fast, reliable developer tools
What's next for Git Whisper 🔮
- GitHub PR and issue ingestion
- Visual timelines of project evolution
- Team-level narratives and contributor insights
- Auto-generated release notes per version
- Continuous “project memory” for long-lived repos
Git Whisper is just the beginning—we want to make software history understandable, not just stored.


Log in or sign up for Devpost to join the conversation.