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
这是什么东西?GitButler 是一个基于 Git 的现代版本控制客户端,同时提供图形界面和命令行工具,从零开始打造,目标是成为比原生 Git 更简单、更强大的替代方案——包括对 AI 和智能体(agent)工作流的支持。
它是桌面应用还是命令行工具?两者都是。它提供基于 Tauri 的桌面图形界面(用 Svelte + TypeScript 做界面,Rust 做后端),以及一个独立的 'but' 命令行工具;两者都是同一个 Rust 引擎的前端。
我怎么把它跑起来?安装桌面应用或 'but' 命令行工具即可;面向最终用户的使用文档在 README 里有链接。如果要从源码构建,需要 Node 24+ 配合 pnpm,以及 Rust/Cargo——运行 pnpm dev:desktop 就能以开发模式启动应用。
用它需要 AI 编程助手或 API 密钥吗?不需要。提交信息、分支名和 PR 描述的 AI 辅助功能都是内置的,GitButler 还可以为现代 agent 系统额外安装钩子(hooks)或技能(skills)。
它会弄乱我已有的 Git 仓库吗?不需要任何迁移:在任何一个已有的 Git 仓库里它都能立即使用,相当于一个更友好的即插即用替代品;所有数据仍然由 Git 托管,所以普通的 Git 命令照样可以和它一起用。
它支持哪些平台?Windows、macOS 和 Linux——基于 Tauri 的应用和命令行工具都支持这三大桌面平台。
它比原生 Git 多了哪些能力?支持堆叠分支(stacked branches)并自动重新变基、支持并行分支让你同时处理多件事而无需来回切换,还有拖拽式的提交管理(取消提交、改写信息、修补、移动、拆分、合并提交),可以取代 rebase -i。
它是怎么处理合并冲突的?变基(rebase)总是能走完,不会卡在半路:提交可以被标记为有冲突,之后随时按任意顺序解决。
如果我不小心搞砸了某个操作怎么办?撤销时间线(Undo Timeline)会记录所有操作和改动,你可以轻松撤销或还原其中任何一步。
它能和代码托管平台集成吗?可以——只需登录一次 GitHub、GitLab 或 Bitbucket,就能创建和更新 Pull Request、查看分支列表、检查 CI 状态,不需要其他任何工具。
Size
316.4 MB
Stars
21.8K
Age
3y
Commits · 90 Days