Show HN: vibe-git - a frictionless git workflow for vibe coding (with MCP)

Never lose work again when AI coding goes wrong.

You're working with AI to build something amazing. The AI is making changes, experimenting, trying different approaches. Then something goes wrong - a bad edit, a mistaken deletion, or the AI gets confused and breaks everything.

Your work is gone.

Whether you're a seasoned developer or completely new to coding, this is infuriating. You can't relax and let the AI explore freely because you're constantly worried about losing progress.

vibe-git automatically commits every single change as you work, so you can completely relax and let AI coding flow:

• 🔄 Every change is instantly saved - No more "oh no, I lost 30 minutes of work"
• 🌊 Let the AI experiment freely - Try wild ideas without fear
• ⏪ Easy to undo anything - Every step is preserved in git history
• 🎯 Clean final result - All those messy auto-commits become one clean, professional commit that represents your final logical change
• 🚀 Automatic pull requests - Share your work with zero git commands

For Git beginners: You don't need to know anything about git. Just code.
For Git experts: You get all the safety of continuous commits with none of the manual work.

1. Start vibing: "Hey Claude, start a vibe session"

   • Creates a safe branch for your experiments
   • Every file change gets automatically committed

2. Code without fear: Make any changes you want

   • Try different approaches, let the AI experiment
   • Everything is safely preserved, always

3. Finish clean: "I'm done, let's create a PR"

   • All the messy "auto-commit" messages disappear
   • You get one clean commit with a proper description of what changed
   • Automatically creates a professional pull request ready for review

• AI-assisted development - Never lose work when the AI makes mistakes
• Rapid prototyping - Experiment freely without git ceremony
• Learning to code - Focus on coding, not git commands
• Pair programming with AI - Let your AI partner be bold and creative
• Exploratory coding - Try ideas without commitment anxiety

• Python 3.13+
• uv package manager
• Git repository with a main or master branch
• GitHub CLI (gh) for automatic PR creation (optional)

Add to your Claude Code .mcp.json configuration:

Important: Replace /path/to/your/git/repository with the absolute path to your git repository.

1. Clone the repository:

2. Install dependencies:

3. Add to your .mcp.json:

Once installed, vibe-git provides three MCP tools:

=� Call this FIRST before making any code changes!

• Creates a new git branch (or reuses existing vibe branch)
• Starts real-time file watching
• Auto-commits every file change instantly

=� Check the current vibe session status

• Shows if you're currently vibing or idle
• Displays the active branch name

<� Call this when you're done with your changes

• Squashes all auto-commits into a single meaningful commit
• Rebases on latest main branch
• Pushes to remote and creates a pull request
• Only call when user explicitly asks to stop!

Before vibe-git: "Claude, can you help me add user authentication?"

• 30 minutes later "Oh no, the AI broke something and I lost all my work!"
• Start over, cautiously

With vibe-git: "Claude, start a vibe session and let's add user authentication!"

• AI experiments freely with different approaches
• You see the history of every change in git
• AI makes a mistake? No problem - every step is saved
• "Let's try that completely differently!" - Go wild!
• "I'm done, create a PR" - Professional result, zero stress

1. "Start vibing"

   • Your AI creates a safe experimental branch
   • Every keystroke is automatically saved

2. Code fearlessly

   • Try different ideas, let the AI experiment
   • Make mistakes - they're all recoverable
   • Focus on the problem, not the process

3. "Let's finish this up"

   • All those messy auto-saves become one clean commit
   • Professional pull request created automatically
   • Ready to share your work

• Uses Python's watchdog library for real-time file system monitoring
• Commits happen instantly when files change (no polling delays)
• Smart filtering ignores .git, __pycache__, .venv, and other temp files
• Rate limiting prevents spam from rapid file changes

• Automatically handles branch creation and switching
• Squashes messy auto-commits into clean, meaningful commits
• Rebases on latest main to avoid merge conflicts
• Creates PRs with descriptive titles and bodies

• Built with FastMCP for reliable protocol compliance
• Proper error handling and status reporting
• Works seamlessly with Claude Code

• Idempotent operations: Safe to call tools multiple times
• Graceful cleanup: File watchers stop properly on session end
• Error recovery: Handles git conflicts and network issues
• State consistency: Detects and recovers from inconsistent states

The server automatically:

• Detects your git repository root
• Finds the main/master branch
• Respects standard gitignore patterns
• Uses timestamps for unique branch names

No additional configuration needed!

Make sure the cwd in your .mcp.json points to a directory inside a git repository.

Ensure your repository has a main or master branch that you can switch to.

Check that:

• You called start_vibing() first
• You're editing files that aren't in .gitignore
• The MCP server is still running (check Claude Code connection status)

Ensure GitHub CLI (gh) is installed and authenticated:

We take code quality seriously! This project features:

• 100% mutation testing score - All mutants killed using mutmut
• Comprehensive integration tests - Testing all MCP tools and edge cases
• CI/CD with GitHub Actions - Automated testing on every PR
• Runtime type safety - Using beartype for validation

To run tests locally:

This project uses modern Python patterns for reliability and maintainability:

• beartype - Runtime type checking for safer code
• plum-dispatch - Multiple dispatch for clean code organization
• Type-safe state machine - Explicit states prevent invalid operations
• Semantic types - GitPath, BranchName, etc. for self-documenting code

Contributions welcome! This is a Python project using:

• FastMCP for MCP server implementation
• watchdog for file system monitoring
• beartype for runtime type validation
• plum for multiple dispatch patterns
• uv for dependency management
• pytest for testing
• mutmut for mutation testing

MIT License - see LICENSE file for details.

Happy vibe coding! 🎉