GitButler CLI Guide

GitButler (but) is a modern Git client that makes history manipulation safe and reversible.

[IMPORTANT] Detect GitButler Workspace

Before running any git commands, check if GitButler is active:

git branch --show-current

If the result is gitbutler/workspace:

• [PREFER] but commands when equivalent exists (commit, squash, undo, amend)
• [OK] Native git for operations but doesn't cover (cherry-pick, stash, tag, revert, blame)
• [CAUTION] Some git commands can corrupt virtual branch state (see below)

Git Command Guidelines: