Skip to content

User-friendly tool to generate customizable scripts for clearing git repository history while preserving your current files.

License

Notifications You must be signed in to change notification settings

AndreaGriffiths11/git-history-cleaner

Repository files navigation

🧹 Git History Cleaner

A user-friendly tool to generate customizable scripts for clearing git repository history while preserving your current files.

Deploy to GitHub Pages

🚀 Live Demo

Try it out: https://andreagriffiths11.github.io/git-history-cleaner/

✨ Features

  • Safe Script Generation - Creates customized bash scripts with proper safety checks
  • Backup Options - Automatically includes backup creation commands
  • Command Explanations - Learn what each git command does in plain English
  • Multiple Output Formats - Copy to clipboard, download as .sh file, or view inline
  • Input Validation - Sanitizes repository names and prevents common errors
  • Customizable - Configure branch names and safety options

🛠️ Local Development

Prerequisites

  • Node.js 20 or higher
  • npm

Setup

# Clone the repository
git clone https://github.com/AndreaGriffiths11/git-history-cleaner.git
cd git-history-cleaner

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

📦 Tech Stack

  • React 19 - UI framework
  • TypeScript - Type safety
  • Vite - Build tool
  • Tailwind CSS - Styling
  • Radix UI - Accessible component primitives
  • Phosphor Icons - Icon library
  • Sonner - Toast notifications

🔒 Safety First

This tool generates scripts that permanently delete git history. Always:

  • ✅ Create backups before running any generated scripts
  • ✅ Review and understand each command
  • ✅ Get team approval for shared repositories
  • ✅ Test on a copy of your repository first

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Built with ❤️ & 🤖

About

User-friendly tool to generate customizable scripts for clearing git repository history while preserving your current files.

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors