Lumberman aims to simplify stacking. It's a CLI that helps you:

• 🚀 Tying into your issue tracker and using it to name branches, so you can quickly get to work
• 🗺️ A consistent, carefully curated set of commands and constantly giving you feedback, so you can navigate with confidence
• 🧠 Strategically synchronising local and remote when it makes sense, so you have to keep less state in your head the amount of state you have to keep in your head by

pipx install lumberman

To see inline documentation:

lumberman

Or the alias:

lm

Let's look at a case! Say you're working on branch A, and you notice you can add an optimisation by making a small configuration change. Previously, you would have to:

1. Switch from branch A to main
2. Pull main to ensure you're aligned with remote
3. Create a new branch from main
4. Name the branch (Patch)
5. Commit changes
6. Push
7. Create a PR
8. Switch to branch A
9. Merge the Patch-cfg branch into branch A

But with lumberman:

1. lm insert bottom
2. Commit changes
3. lm sync
4. lm top

1. Install Orbstack or Docker Desktop. Make sure to complete the full install process before continuing.
2. If not installed, install VSCode
3. Press this link
4. Complete the setup process
5. Done! Easy as that.