gitbutler README

The project's README from github.com/gitbutlerapp/gitbutler. As one markdown file: README.md.

GitButler logo

GitButler

Git, but better.
GitButler is a modern Git-based version control interface with both a GUI and CLI built from the ground up for AI-powered workflows.

Website   •   Blog   •   Docs   •   Downloads


GitButler desktop app preview

Our beautiful GUI

GitButler CLI preview

Our amazing but CLI


TWEET BLUESKY DISCORD

CI INSTA YOUTUBE DEEPWIKI


GitButler is a powerful new Git-based version control system, designed from scratch to be simple, powerful and flexible. It is designed for ease of use and modern agentic workflows.

It features stacked branches, parallel branches, unlimited undo, easy commit mutations, forge integrations and more.

Works instantly in any existing Git repo as a friendlier and more powerful drop-in Git user interface replacement - for you and your agents.

Main Features

Why use GitButler instead of vanilla Git? What a great question.

Tech

The GitButler desktop app is a Tauri-based application. Its UI is written in Svelte using TypeScript and its backend is written in Rust.

The but CLI is the same Rust backend engine with a Rust command line UI.

Documentation

You can find our end user documentation at: https://docs.gitbutler.com

Bugs and Feature Requests

If you have a bug or feature request, feel free to open an issue, or join our Discord server.

License

The TLDR is that GitButler is under a Fair Source software license, meaning that you can use it, view the source, contribute, etc. You just can't build a competitor with it. It also becomes MIT after 2 years. So, MIT with an expiring non-compete clause.

Contributing

So you want to help out? Please check out the CONTRIBUTING.md document.

If you want to skip right to getting the code to actually compile, take a look at the DEVELOPMENT.md file.

Contributors

gitbutler (gitbutlerapp/gitbutler)

Searching Database…

21.8K ·GitHub
What is this?GitButler is a modern Git-based version control client with both a GUI and a CLI, built from scratch to be a simpler, more powerful alternative to vanilla Git — including for AI-powered and agentic workflows.
Is this a desktop app or a command-line tool?Both. It ships a Tauri-based desktop GUI (Svelte + TypeScript UI over a Rust backend) and a separate 'but' CLI; both are frontends onto the same Rust engine.
How do I get it running?Install the desktop app or the 'but' CLI; end-user documentation is linked in the README. Building from source needs Node 24+ with pnpm and Rust/Cargo — pnpm dev:desktop runs the app in dev mode.
Do I need an AI coding agent or an API key to use it?No. AI helpers for commit messages, branch names and PR descriptions are built in, and GitButler can additionally install hooks or skills for modern agent systems.
Will it mess with my existing Git repos?No migration needed: it works instantly in any existing Git repo as a friendlier drop-in replacement, and everything stays backed by Git, so plain Git commands still work alongside it.
Which platforms does it run on?Windows, macOS and Linux — the Tauri-based app and the CLI target all three desktop platforms.
What can it do that vanilla Git can't?Stacked branches with automatic restacking, parallel branches for working on several things at once without switching, and drag-and-drop commit management (uncommit, reword, amend, move, split, squash) that replaces rebase -i.
How does it handle merge conflicts?Rebases always succeed instead of stopping halfway: commits can be marked as conflicted and resolved at any time, in any order.
What if I botch an operation?The Undo Timeline logs all operations and changes, so you can easily undo or revert any of them.
Does it integrate with code hosting services?Yes — authenticate to GitHub, GitLab or Bitbucket once to open and update Pull Requests, list branches and check CI statuses, with no other tools required.
Size
315.7 MB
Stars
21.8K
Age
3y
Commits · 90 Days