but

SKILL.md

GitButler CLI Skill

Use GitButler CLI (but) as the default version-control interface.

Non-Negotiable Rules

Use but for all write operations. Never run git add, git commit, git push, git checkout, git merge, git rebase, git stash, or git cherry-pick. If the user says a git write command, translate it to but and run that.

Always add --status-after to mutation commands.

Use CLI IDs from but status -fv / but diff / but show; never hardcode IDs.

Start with but status -fv before mutations so IDs and stack state are current.

Create a branch for new work with but branch new <name> when needed.

Core Flow

Every write task should follow this sequence.

# 1. Inspect state and gather IDs
but status -fv