Stack

Stacked diffs. Simplified.

Stack is an open-source CLI for managing stacked pull requests on GitHub and GitLab. Break large changes into small, reviewable PRs that stay in sync automatically.

Large PRs 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.

# Quick install (downloads binary or builds from source)
curl -fsSL https://raw.githubusercontent.com/neul-labs/stkd/main/install.sh | bash

# Or install from crates.io
cargo install stkd-cli

# Or via npm
npm install -g stkd-cli

# Or via pip
pip install stkd-cli

# Or build from source
cargo install --path crates/stkd-cli

The binary is named gt for Graphite compatibility.

# Initialize in your repository
gt init

# Authenticate with GitHub or GitLab
gt auth --github

# Create a stack of branches
gt create feature/step-1    # First branch on main
# ... make changes, commit ...

gt create feature/step-2    # Stacks on step-1
# ... make changes, commit ...

gt create feature/step-3    # Stacks on step-2
# ... make changes, commit ...

# See your stack
gt log
# ○ feature/step-1
#   ○ feature/step-2
#     ◉ feature/step-3  ← you are here

# Or explore interactively
gt tui

# Submit all as PRs
gt submit --stack

• Auto-restack: Edit any branch, all dependents rebase automatically
• GitHub + GitLab: Full support for both platforms
• PR automation: Reviewers, labels, templates, draft PRs
• Stack-aware submit: One command creates PRs for your entire stack
• Interactive TUI: Keyboard-driven terminal UI for browsing stacks and status
• MCP Server: AI agent integration via Model Context Protocol
• Web Dashboard: Self-hosted visualization and management UI
• Conflict handling: gt continue / gt abort for rebase conflicts
• Undo/redo: Recover from mistakes with gt undo

See Stack in action with an interactive demo:

./demo.sh

Full documentation at docs.neullabs.com/stkd:

• Getting Started — Installation, quick start, first stack, authentication
• Concepts — How stacked diffs work
• Command Reference — All commands with examples and flags
• Guides:
  • Interactive TUI — Keyboard-driven terminal UI
  • Restacking Deep Dive
  • Branch Management
  • Advanced Submit
  • Stack Templates
  • Performance & Large Repos
  • Day in the Life
  • Web Dashboard
  • MCP Server for AI Agents
  • Open Source Maintainers
  • Migrating from Graphite
  • Migrating from Git

crates/
├── stkd-cli          # CLI binary (gt)
├── stkd-core         # Core library (Repository, Stack, DAG)
├── stkd-engine       # Programmatic engine for multi-agent harnesses
├── stkd-mcp          # MCP server for AI agent integration
├── stkd-provider-api # Provider trait definitions
├── stkd-github       # GitHub implementation
├── stkd-gitlab       # GitLab implementation
├── stkd-db           # Database layer (SQLite/PostgreSQL)
└── stkd-server       # Web dashboard API

git clone https://github.com/neul-labs/stkd
cd stkd
cargo build
cargo test

See CONTRIBUTING.md for guidelines.

Apache-2.0 - See LICENSE for details.

Built by Neul Labs