but Skill

Commit, push, branch, and manage version control with GitButler. Use for commits, selective dirty-file or hunk commits, branches, diffs, PRs, history edits, squashes, amends, undo, merge, apply, and unapply. For selected dirty files or hunks, inspect with `but diff`; use compact `but status` for commit order, branch/stack placement, or conflict overview; use `but status -fv` when file/hunk IDs or per-commit file details matter. Replaces git write commands.

Install
npx skills add 'https://github.com/gitbutlerapp/gitbutler/tree/master/crates/but/skill'
Incomplete bundle · no download
View on GitHub
← Back to SKILL.md

GitButler CLI Skill

This file is a discovery stub. The usage guide is printed by the CLI, so it always matches the installed version. Before your first but command, run it on its own and read all of it; it is about 200 lines, and other commands in the same call get buried under it:

but skill

The guide covers the loop, IDs, rules, and task recipes. When you need a flag it does not mention, but skill reference prints each command's syntax and flags.

Follow the guide's applicable recipes and stopping rules.