Lumberman

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

Installation

pipx install lumberman

Usage

To see inline documentation:

lumberman

Or the alias:

lm

Case study

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

Setting up a development environment

Devcontainer

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.

💬 Where to ask questions

Type
🚨 Bug Reports	GitHub Issue Tracker
🎁 Feature Requests & Ideas	GitHub Issue Tracker
👩‍💻 Usage Questions	GitHub Discussions
🗯 General Discussion	GitHub Discussions