Commands Overview

Command reference

Basics

• setup: Set up a Git repository to be managed by GitButler
• teardown: Exit GitButler mode and return to normal Git

Inspection

• status: Show the project workspace state
• diff: Show a diff for the workspace or a CLI ID
• show: Show information about a commit or branch
• help cli-ids: Learn how to use IDs from command output

Branching and committing

• commit: Commit changes to a stack
• branch: Commands for managing branches
• discard: Discard uncommitted changes
• resolve: Resolve conflicts in a commit
• unapply: Unapply a branch from the workspace
• apply: Apply a branch to the workspace
• clean: Remove empty branches from the workspace
• pick: Cherry-pick a commit from an unapplied branch

Server interactions

• push: Push changes in a branch to remote
• pull: Pull upstream changes and update your branches
• pr: Create and manage reviews on GitHub, GitLab, and other forges
• land: Land a branch directly onto the target branch

Editing commits

• absorb: Amend changes into the commits where they belong
• reword: Edit a commit message or branch name
• uncommit: Move commit changes back to the uncommitted area
• amend: Amend a file change into a commit
• squash: Squash commits together
• move: Move a commit or branch to a different location

Operations log

• oplog: View and manage operation history
• undo: Undo the last operation
• redo: Redo the last undo

Helper commands

• gui: Open the GitButler GUI for the current project
• tui: Open the interactive terminal UI
• update: Manage GitButler CLI and app updates
• completions: Generate shell completions
• alias: Manage command aliases
• config: View and manage GitButler configuration
• agent: Set up GitButler for AI coding agents
• skill: Manage AI agent skills for GitButler