Deprecated: This module has moved to github.com/KulkarniKaustubh/ezstack/v4.
The highest tagged major version is
README
¶
ezstack
Manage stacked PRs with git worktrees
Requirements
- Git 2.20+
- fzf for interactive selection
- GitHub CLI (
gh) for PR operations
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 and ezs new 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 with PR and CI status
ezs status
# Create PRs
ezs pr create -t "Part 1: Add feature"
# Sync after changes
ezs sync -a
Commands
| Command | Aliases | Description |
|---|---|---|
new |
n |
Create a new branch in the stack |
list |
ls |
List all stacks and branches |
status |
st |
Show status with PR and CI info |
sync |
rebase, rb |
Sync stack with remote |
goto |
go |
Navigate to a branch worktree |
reparent |
rp |
Change the parent of a branch |
stack |
Add a branch to a stack | |
unstack |
Remove a branch from tracking | |
update |
up |
Sync config with git (detects renames, orphans) |
delete |
del, rm |
Delete a branch and its worktree |
pr |
Manage pull requests | |
config |
cfg |
Configure ezstack |
Global flags: -y, --yes auto-confirm prompts · -h, --help · -v, --version
Run ezs <command> --help for command-specific help, or just ezs for an interactive menu.
Documentation
See DOCUMENTATION.md for comprehensive documentation.
License
MIT
Directories
Click to show internal directories.
Click to hide internal directories.