Working with AI

Use --ai when you want the CLI to generate text for a single command. Use but skill install when you want a coding agent to use GitButler's version-control workflow.

--ai options

Supported commands can take --ai to generate text from your current changes.

but commit --ai

Use but commit --ai to generate a commit message from the changes you are committing.

This commits the selected work with the generated message. You can edit the message afterward with but reword <commit>.

but squash --ai

Use but squash --ai to generate a combined commit message when squashing commits.

but skill install

If your coding agent can read skills, install the GitButler skill with but skill install.

but skill install

The command prompts for install scope and skill format. It can install local or global skills for Agent Skills (.agents), Claude Code, OpenCode, Codex, GitHub Copilot, Cursor, and Windsurf.

To update an existing install without going through the prompts, run:

but skill install --detect

We keep these templates up to date, so update the skill after updating GitButler.

Agent workflow docs

but skill install is only the install step. For the full workflow:

• Start with AI agents overview.
• Install and configure the skill with Getting started with AI agents.
• Use Useful requests for prompt examples.
• Use Tuning agent behavior for standing instructions.