panqake 0.5.0

Git Branch Stacking Utility

Panqake: Stack Git Branches Without the Headache

Panqake is a CLI tool that makes managing dependent pull requests significantly easier by automating the entire git-stacking workflow. Stop dealing with painful rebases and focus on your code instead.

What Problems Panqake Solves

• Reviews no longer block progress on dependent work
• Simplify complex workflows with a single command for common operations
• Eliminate manual rebasing when working with dependent branches
• Automate PR management for each branch in your stack

Quick Installation

uv tool install panqake

Optional dependency:

• gh: GitHub CLI (needed only for PR creation/management)

Most-Used Commands

Command	Purpose	What It Does
panqake new feature-name	Create branches	Creates a new branch based on your current branch
panqake modify	Commit changes	Interactively select files to stage and commit/amend
panqake update	Propagate changes	Rebases all child branches and updates their PRs
panqake merge	Complete workflow	Merges PR and updates all dependent branches

Real-World Workflow Example

Here's how to build a stack of dependent features:

# Start from main
git checkout main

# Create your base feature branch
pq new auth-backend
# Make changes, commit them
pq modify -m "Implement JWT authentication"

# Create a dependent branch for frontend work
pq new auth-frontend
# Make changes, commit them
git add .
pq modify -m "Add login form UI"

# Oops! Need to fix something in the backend branch
pq switch auth-backend
# Make your backend fixes

# Commit the fixes and automatically update child branches
pq modify -m "Fix token validation"
pq update

# Create PRs for your entire stack with a single command
pq pr

# When the first PR is approved, merge it and update the stack
panqake merge auth-backend

Advanced Features

Track Existing Git Branches

Add branches created outside panqake to your stack:

pq track feature-branch

Flexible Commit Creation

# Amend existing Commit
pq modify

# Force creating a new commit instead of amending
pq modify --no-amend

# Or explicitly
pq modify --commit -m "New feature implementation"

Delete a Branch While Preserving the Stack

pq delete feature-old

Why Choose Panqake

• Designed for real workflows: Stack PRs without effort
• Reduces context switching by making branch navigation seamless
• Single command operations: Complex git operations condensed to simple commands
• GitHub integration: Seamlessly works with GitHub PRs

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT