git-spice

git-spice

Introduction

git-spice is a tool for stacking Git branches. It lets you manage and navigate stacks of branches, conveniently modify and rebase them, and create GitHub, Bitbucket, Gitea, or Forgejo Pull Requests or GitLab Merge Requests from them.

See for more details.

Usage looks roughly like this:

# Stack a branch on top of the current branch.
$ gs branch create feat1

# Stack another branch on top of feat1.
$ gs branch create feat2

# Submit pull requests for feat1 and feat2.
$ gs stack submit

# Pull latest changes from the remote repository
# and delete merged branches.
$ gs repo sync

# Restack branches on top of the latest changes.
$ gs stack restack

Or equivalently, using CLI shorthands:

$ gs bc feat1  # branch create feat1
$ gs bc feat2  # branch create feat2
$ gs ss        # stack submit
$ gs rs        # repo sync
$ gs sr        # stack restack

Features

• Create, edit, and navigate stacks of branches with ease.
• Submit the entire stack or parts of it with a single command. Supports GitHub, GitLab, Bitbucket, Gitea, and Forgejo hosts such as Codeberg.
• Keep using your existing workflow and adopt git-spice incrementally.
• Completely offline operation with no external dependencies until you push or pull from a remote repository.
• Easy-to-remember shorthands for most commands.

Documentation

See for the full documentation.

Sponsors

License

This software is distributed under the GPL-3.0 License:

…

See LICENSE for details.