# gitbutler | GitButler | Knowledge Base | Instagit

The GitButler version control client, backed by Git, powered by Tauri/Rust/Svelte

GitHub Stars: 19.3k

Repository: https://github.com/gitbutlerapp/gitbutler

---

## Articles

### [GitButler CLI Output Formatting Modes: Human, Shell, JSON, and None Explained](/gitbutlerapp/gitbutler/gitbutler-but-cli-output-formatting-modes)

Master GitButler CLI output with Human, Shell, JSON, and None modes. Learn to control command results using format flags or environment variables for better workflows.

- Tags: deep-dive
- Published: 2026-02-19

### [GitButler Push Operation Edge Cases: Handling Remote Divergence, Force Protection, and Virtual Stacks](/gitbutlerapp/gitbutler/gitbutler-push-operation-edge-cases)

Master GitButler push edge cases like remote divergence and force protection. GitButler's target-centric abstraction ensures safe and validated pushes.

- Tags: deep-dive
- Published: 2026-02-16

### [GitButler Project Configuration Storage: Architecture and Implementation Guide](/gitbutlerapp/gitbutler/gitbutler-project-configuration-storage)

Explore GitButler project configuration storage. Learn how GitButler manages JSON and TOML files for global and per-project settings, plus live watching and automatic migrations.

- Tags: architecture
- Published: 2026-02-16

### [GitButler Rust Backend Architecture: A Deep Dive into the Modular Design](/gitbutlerapp/gitbutler/gitbutler-rust-backend-architecture)

Explore the GitButler Rust backend architecture featuring a modular crate design and a global Context for efficient virtual branch state and octopus-merge calculations.

- Tags: architecture
- Published: 2026-02-16

### [How the gitbutler-* Crates Interact: A Deep Dive into GitButler's Modular Rust Architecture](/gitbutlerapp/gitbutler/interaction-gitbutler-crates)

Explore how gitbutler-* Rust crates interact within GitButler. Understand its modular architecture, clean dependencies, and fast compilation for efficient Git workflows.

- Tags: deep-dive
- Published: 2026-02-16

### [How GitButler Implements Branch Absorption: A Deep Dive into the Source Code](/gitbutlerapp/gitbutler/how-gitbutler-implements-branch-absorption)

Explore how GitButler implements branch absorption by analyzing worktree changes, resolving commits, and amending with the legacy absorb API. Dive into the source code.

- Tags: deep-dive
- Published: 2026-02-16

### [GitButler CLI Command Structure: Architecture and Implementation Guide](/gitbutlerapp/gitbutler/gitbutler-but-cli-command-structure)

Explore the GitButler CLI command structure, detailing its parse-context-dispatch architecture, Clap for parsing, Context for state management, and command implementations for efficient Git workflows.

- Tags: architecture
- Published: 2026-02-16

### [GitButler Uncommitted File Tracking Mechanism: Real-Time Redux Streaming Architecture](/gitbutlerapp/gitbutler/gitbutler-uncommitted-file-tracking-mechanism)

Discover GitButler's real-time uncommitted file tracking powered by Redux streaming. Efficiently manage worktree changes, hunks, and selections with a normalized store.

- Tags: internals
- Published: 2026-02-16

### [How GitButler's Parallel Branch System Works: A Deep Dive into Virtual Stacking](/gitbutlerapp/gitbutler/how-gitbutler-parallel-branch-system-works)

Explore GitButler's innovative parallel branch system. Learn how virtual stacks enable simultaneous development and dynamic merging into a single workspace branch for efficient workflows.

- Tags: deep-dive
- Published: 2026-02-16

### [How GitButler Commit Editing Works: Amend, Reword, and Squash Explained](/gitbutlerapp/gitbutler/under-hood-gitbutler-commit-editing)

Explore GitButler's commit editing workflow. Learn how amend, reword, and squash commands are processed through Svelte and RTK-Query for efficient Git command translation. See how it works.

- Tags: internals
- Published: 2026-02-16

### [How GitButler Oplog Revert Operations Restore Repository State](/gitbutlerapp/gitbutler/how-gitbutler-oplog-reverts-operations)

Discover how GitButler oplog revert operations restore repository state. Learn how GitButler loads snapshots to reconstruct your entire repository, ensuring a full recovery.

- Tags: internals
- Published: 2026-02-16

### [GitButler GitLab Integration for PR Status Checking: A Complete Technical Guide](/gitbutlerapp/gitbutler/gitbutler-gitlab-integration-pr-status-checking)

Master GitButler GitLab integration for PR status checking. This technical guide shows how to streamline MR workflows using a unified Rust API.

- Tags: how-to-guide
- Published: 2026-02-16

### [Integrating LLMs with GitButler AI Tooling: A Complete Guide to the but-llm Crate](/gitbutlerapp/gitbutler/integrating-llms-gitbutler-ai-tooling)

Explore the but-llm crate for seamless LLM integration with GitButler AI. Connect OpenAI, Anthropic, Ollama, and LMStudio using a provider-agnostic interface configured via Git settings.

- Tags: tutorial
- Published: 2026-02-16

### [GitButler GitHub Integration for PR Creation: Architecture and Implementation](/gitbutlerapp/gitbutler/gitbutler-github-integration-pr-creation)

Learn how GitButler integrates with GitHub to create pull requests using a typed service layer and robust retry logic for reliable PR creation. Explore its architecture and implementation.

- Tags: architecture
- Published: 2026-02-16

### [GitButler Stacked Branch Restacking on Commit Amend: A Technical Deep Dive](/gitbutlerapp/gitbutler/gitbutler-stacked-branch-restacking-commit-amend)

Discover how GitButler's stacked branch restacking automatically rebasess descendant commits on commit amend This technical deep dive explains the linear and consistent virtual stack

- Tags: deep-dive
- Published: 2026-02-16

### [GitButler First-Class Conflict Resolution Order: Technical Architecture and CLI Workflow](/gitbutlerapp/gitbutler/gitbutler-first-class-conflict-resolution-order)

GitButler revolutionizes merge conflict resolution by treating conflicts as persistent objects. Resolve them in any order while maintaining stack integrity with automatic rebasing. Learn the technical architecture and CLI workf...

- Tags: architecture
- Published: 2026-02-16

### [How GitButler's Oplog Tracks Operations: A Deep Dive into Snapshot-Based History](/gitbutlerapp/gitbutler/how-gitbutler-oplog-tracks-operations)

Explore how GitButler's oplog tracks operations using immutable snapshot commits. Understand its Git-based history and gain insights into virtual-branch metadata and operational details.

- Tags: deep-dive
- Published: 2026-02-16

### [How GitButler Implements Virtual Branches: Inside the Stack-Based Architecture](/gitbutlerapp/gitbutler/how-gitbutler-implements-virtual-branches)

Discover how GitButler implements virtual branches using a stack-based architecture and lightweight TOML configuration to manage parallel workstreams efficiently without ref namespace clutter.

- Tags: internals
- Published: 2026-02-16

### [How GitButler Manages Its Staging Area: Virtual Index Architecture](/gitbutlerapp/gitbutler/gitbutler-staging-area-management)

Discover how GitButler uses a virtual staging area and assignment database to manage changes and track hunk-to-branch relationships without altering the Git index for efficient commits.

- Tags: internals
- Published: 2026-02-16

### [How the GitButler CLI Processes Commands: Architecture and Execution Flow](/gitbutlerapp/gitbutler/gitbutler-cli-command-processing)

Discover how the GitButler CLI processes commands using its three-layer architecture. Learn about argument parsing, dispatch, and command module execution for GitButler APIs.

- Tags: architecture
- Published: 2026-02-16

### [How GitButler's Virtual Branch System Works: Architecture and Implementation](/gitbutlerapp/gitbutler/gitbutler-virtual-branch-explained)

Discover how GitButler's virtual branch system works. Explore its architecture, lightweight branches, and TOML metadata storage for efficient Git workflows.

- Tags: architecture
- Published: 2026-02-16