stck

stck is a Rust CLI for working with stacked GitHub pull requests.

Stacked PRs improve review quality and throughput, but day-to-day maintenance can be tedious and error-prone. stck focuses on automating the repetitive mechanics while staying close to native git and gh behavior.

Status

First public release (v0.1.0).

Basic Usage

Command surface:

stck new <branch>
stck submit [--base <branch>]
stck status
stck sync
stck push

stck new <branch> works both when starting from the default branch and when stacking on top of an existing branch.

Git subcommand entrypoint is also installed (when installed via homebrew):

git stck <command>

Installation

Homebrew (recommended)

brew tap brdv/stck https://github.com/brdv/stck
brew install brdv/stck/stck

Verify installation:

stck --version
stck --help
git stck --help

From source

cargo build --release --all-features
./target/release/stck --help

Homebrew release details are documented in docs/release-homebrew.md.

Goal

stck aims to make stacked PR workflows predictable and low-friction by providing a small set of commands to:

• create the next branch in a stack,
• inspect stack and PR state,
• restack/rebase locally after upstream changes,
• push rewritten branches and update PR base relationships.

Usage

For a step-by-step tutorial and command behavior details, see USAGE.md.

Contributing

Development and validation commands live in CONTRIBUTING.md.