GitButler CLI Skill

Help users work with GitButler CLI (but command) in workspace mode.

New Session Workflow

EVERY new agent session that involves code changes MUST follow this flow:

1. Sync first → but pull to get latest upstream changes (prevents conflicts and stale base)
2. Check state → but status to see existing branches and unstaged changes
3. Decide branch →
   • If an existing branch matches the task → reuse it (it's already applied)
   • If this is new work → but branch new <task-name> (e.g. feat/add-auth, fix/login-bug)
   • If you need to resume unapplied work → but apply <branch>
4. Make changes → Edit files as needed
5. Stage & commit → but commit <branch> -m "message" --changes <id>,<id>
6. Refine → Use but absorb or but squash to clean up history
7. Push when ready → but push <branch>
8. Create PR → but pr new <branch> -t (uses default target branch)