stkd-cli

Stack CLI distributed via PyPI — Install the gt binary for managing stacked pull requests on GitHub and GitLab.

Stack is an open-source, Graphite-compatible CLI that breaks large changes into small, reviewable PRs that stay in sync automatically. This Python package downloads the correct prebuilt binary for your platform (macOS, Linux) and installs it as the gt command.

What is Stack?

Large pull requests are hard to review. Stacked diffs let you split work into a chain of dependent branches, each with its own focused PR:

main
 └── feature/auth-base      PR #1: Core authentication
      └── feature/auth-oauth    PR #2: OAuth support (depends on #1)
           └── feature/auth-2fa     PR #3: 2FA (depends on #2)

When you update a branch, Stack automatically rebases all dependent branches. When PRs merge, the stack collapses cleanly.

Why Stacked Diffs?

Features

• Auto-restack — Edit any branch, all dependents rebase automatically
• GitHub + GitLab — Full support for both platforms, including self-hosted GitLab
• Stack-aware submit — One command creates PRs for your entire stack
• Interactive TUI — Keyboard-driven terminal UI for browsing stacks
• MCP Server — AI agent integration via Model Context Protocol
• Undo/redo — Recover from mistakes with gt undo
• Graphite compatible — Drop-in replacement for gt commands

Installation

pip install stkd-cli

With uv

uv pip install stkd-cli

In a virtual environment

python -m venv .venv
source .venv/bin/activate
pip install stkd-cli

Quick Start

# Initialize in your repository
gt init

# Authenticate with GitHub or GitLab
gt auth --github

# Create a stack
gt create feature/step-1
gt create feature/step-2
gt create feature/step-3

# Submit all as PRs
gt submit --stack

Platform Support

• macOS (Intel & Apple Silicon)
• Linux (x86_64 & aarch64)

If a prebuilt binary is not available for your platform, the installer falls back to building from source with cargo.

Python API

from stkd_cli import run, run_json

# Run a command
result = run(["log", "--json"])
print(result.stdout)

# Run and parse JSON
stack = run_json(["log"])
print(stack)

Documentation

Full documentation at docs.neullabs.com/stkd.

License

Apache-2.0. See LICENSE for details.

Built by Neul Labs.