commits-nuke 1.0.0

Instantly reset Git history to a single fresh commit.

🚀 commits-nuke

Instantly collapse your entire Git history into a single, fresh initial commit.

commits-nuke is a CLI tool that wipes your local commit history while keeping your current files exactly as they are. It automates the git checkout --orphan process into a single, safe command.

📦 Installation

Recommended (uv)

uv tool install commits-nuke

Standard (pip)

pip install commits-nuke

⌨️ Usage

Run this command inside any local Git repository:

# Default: creates an "Initial commit"
commits-nuke

# Custom message:
commits-nuke "Clean start"

# Check version or help:
commits-nuke -v
commits-nuke -h

Capabilities

• Auto-Branch Detection: Detects your active branch (main, master, etc.) and replaces it seamlessly.
• Safety Catch: Interactive y/N confirmation prevents accidental execution.
• Files Preserved: Your current working directory remains untouched; only history is purged.
• Visual Feedback: Provides a dramatic ASCII confirmation upon success.
• Zero Dependencies: Uses only Python standard libraries.

Execution Steps

1. Identifies the active branch name.
2. Creates a temporary orphan branch (no history).
3. Stages all current files and creates a new root commit.
4. Deletes the original branch and renames the orphan branch to match.

---

⚠️ Warning

This action is destructive. It permanently removes all previous local commits. Use only when you want to reset a repository's history to a "Day 1" state.

📜 License

MIT