ezstack

module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 6, 2026 License: MIT

README

ezstack

Manage stacked PRs with git worktrees (beta)

Go Version License Beta

⚠️ BETA SOFTWARE: This tool is currently in beta and under heavy development. It is subject to major changes at any time.


Requirements

Installation

Homebrew (macOS/Linux)
brew tap KulkarniKaustubh/ezstack
brew install ezstack
Go Install
go install github.com/KulkarniKaustubh/ezstack/cmd/ezs@latest
From Source
git clone https://github.com/KulkarniKaustubh/ezstack.git
cd ezstack
make install
Shell Integration (Required)

Add to your ~/.bashrc or ~/.zshrc:

eval "$(ezs --shell-init)"

This creates a shell function that wraps the ezs binary, enabling commands like ezs goto to change your shell's directory.

Quick Start

# Configure ezstack for your repository
ezs config

# Create your first branch
ezs new feature-1

# Stack another branch on top
ezs new feature-2 --parent feature-1

# View your stack
ezs status

# Create PRs
ezs pr create -t "Part 1: Add feature"

# Sync after changes
ezs sync

Commands

Command Description
new Create a new branch in the stack
list List all stacks and branches
status Show status of current stack
sync Sync stack with remote
goto Navigate to a branch worktree
reparent Change the parent of a branch
stack Add a branch to a stack
unstack Remove a branch from tracking
update Sync config with git
delete Delete a branch and its worktree
pr Manage pull requests
config Configure ezstack

Run ezs <command> --help for command-specific help.

Documentation

See DOCUMENTATION.md for comprehensive documentation.

License

MIT

Directories

Path Synopsis
cmd
ezs command
internal
git
helpers
Package helpers provides shared utility functions for the ezstack CLI.
Package helpers provides shared utility functions for the ezstack CLI.
ui

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL