https://github.com/kmdtaufik/nix4gitbutler
GitButler Binaries for Nix
https://github.com/kmdtaufik/nix4gitbutler
butler cli git gitbutler nix nixos
Last synced: 19 days ago
JSON representation
GitButler Binaries for Nix
- Host: GitHub
- URL: https://github.com/kmdtaufik/nix4gitbutler
- Owner: kmdtaufik
- Created: 2026-02-22T15:03:00.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-05-09T06:13:05.000Z (about 1 month ago)
- Last Synced: 2026-05-09T08:26:49.259Z (about 1 month ago)
- Topics: butler, cli, git, gitbutler, nix, nixos
- Language: Nix
- Homepage:
- Size: 22.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# nix4gitbutler
**A Nix flake providing pre-compiled binaries for GitButler (GUI & CLI)**
[](https://nixos.org/)
[](https://gitbutler.com)
---
## About GitButler
**GitButler** is a modern Git-based version control interface built from the ground up for AI-powered workflows. This flake pulls the official upstream `.deb` and CLI binaries and patches them for NixOS, completely bypassing the heavy Rust/Tauri compile times.
### Available Packages
This flake exposes two explicit outputs:
- `gui` (Default): The full Tauri desktop application. This package _also_ includes the `but` CLI wrapper.
- `cli`: The standalone, lightweight Rust binary (`but`) for terminal-only workflows.
🚨 **IMPORTANT: Mutual Exclusivity** 🚨
Do **not** attempt to install both the `gui` and `cli` packages simultaneously. Because both packages provide the `/bin/but` executable, Nix's native environment builder will throw a file collision error and refuse to build your system. Choose one or the other.
---
## Installation
### NixOS Configuration (Flake)
Add the flake to your `flake.nix` inputs:
```nix
{
inputs = {
nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
nix4gitbutler.url = "github:kmdtaufik/nix4gitbutler";
};
outputs = { nixpkgs, inputs, ... }: {
nixosConfigurations.yourhostname = nixpkgs.lib.nixosSystem {
system = "x86_64-linux";
modules = [{
# 🟢 Option A: Install the full Desktop GUI (Default)
environment.systemPackages = [
inputs.nix4gitbutler.packages.x86_64-linux.default
];
# 🔵 Option B: Install ONLY the Terminal interface (CLI)
# environment.systemPackages = [
# inputs.nix4gitbutler.packages.x86_64-linux.cli
# ];
}];
};
};
}
```
### Home Manager
```nix
{
inputs = {
nix4gitbutler.url = "github:kmdtaufik/nix4gitbutler";
};
outputs = { inputs, ... }: {
home.packages = [
inputs.nix4gitbutler.packages.x86_64-linux.default # Choose GUI...
# inputs.nix4gitbutler.packages.x86_64-linux.cli # ...Or CLI
];
};
}
```
### Try without installing
You can run either application instantly without modifying your system configuration:
```bash
# Run the Desktop GUI
nix run github:kmdtaufik/nix4gitbutler
# Run the pure CLI
nix run github:kmdtaufik/nix4gitbutler#cli
```