DEV Community

Ethern Myth
Ethern Myth

Posted on

Create Orphan Git Branches Easily with git-newroot

Have you ever needed a Git branch with zero history — one that doesn’t track main or master or pull in unrelated changes?

Say hello to git-newroot — a CLI tool that creates clean orphan branches in seconds.


🔧 Why Use This?

Sometimes, you want a branch that:

  • Doesn’t inherit any commits from main
  • Is used for static sites (gh-pages), demos, or release snapshots
  • Won’t confuse GitHub with “main is behind” messages

That’s where an orphan branch comes in — and git-newroot makes it dead simple to create.


📦 Install (or use instantly)

# Global install
npm install -g git-newroot

# OR run it instantly without installing
npx git-newroot

# OR even better
git-newroot
Enter fullscreen mode Exit fullscreen mode

⚙️ Usage

git-newroot [branch-name]
Enter fullscreen mode Exit fullscreen mode

If no name is given, it defaults to version-1
Pushes to remote automatically if configured

🧪 Example:

git-newroot version-2
Enter fullscreen mode Exit fullscreen mode

➡️ Creates a new version-2 branch with no history, adds a README.md, commits it, and pushes it (if a remote exists).

🎥 Demo

Check out the full usage demo on GitHub:
👉 https://github.com/Ethern-Myth/git-newroot-demo

For package information:
https://www.npmjs.com/package/git-newroot

🔁 Real-world Use Cases

  • 🔄 Start over clean on a new idea

  • 🚀 Deploy static sites with a fresh branch

  • 🔒 Keep feature branches isolated from history

  • 🧪 Prototype freely without main or master pollution

Give it Try and walk away from manually recreating new branches.

Warp.dev image

The best coding agent. Backed by benchmarks.

Warp outperforms every other coding agent on the market, and gives you full control over which model you use. Get started now for free, or upgrade and unlock 2.5x AI credits on Warp's paid plans.

Download Warp

Top comments (0)