ziggity

<p align="center">
  <img src="docs/assets/ziggity-icon.svg" alt="Ziggity icon" width="128" height="128">
</p>

<h1 align="center">ziggity</h1>

<p align="center">
  A fast terminal UI for Git, written in Zig.
</p>

<p align="center">
  <b>Fast with the keyboard.</b><br>
  <b>Natural with the mouse.</b><br>
  <b>No compromises.</b>
</p>

<p align="center">
  <a href="https://ziggity.dev"><img alt="Website" src="https://img.shields.io/badge/website-ziggity.dev-f7a41d"></a>
  <img alt="Zig 0.17" src="https://img.shields.io/badge/Zig-0.17.1-f7a41d">
  <img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue">
  <img alt="Platform" src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows%20%7C%20Android-lightgrey">
</p>

<p align="center">
  <b><a href="https://ziggity.dev">ziggity.dev</a></b>
</p>

<p align="center">
  <b>1.9 MB</b> binary · <b>3.2 ms</b> startup · <b>10 MB</b> memory when idle · no runtime, no toolchain, just <code>git</code>
</p>

<p align="center">
  <img src="docs/assets/ziggity-donut.gif" alt="Ziggity, the about splash with a spinning donut" width="900">
</p>

<p align="center"><i>The Status panel about splash. Yes, the donut spins.</i></p>

Ziggity keeps your entire Git workflow in one terminal window. Stage individual
lines, commit, branch, rebase interactively, inspect history, and review
changes with live diff previews. Every action is a keystroke. 
Any text can be selected and copied with the mouse. 

Long running Git operations never block the interface. Fetch, pull, push,
merge, rebase, autosquash, and bisect run in the background while navigation
remains responsive. Ziggity also includes thoughtful defaults that remove
friction from everyday workflows: checking out a remote branch tracks it
automatically, rejected pushes try the safe force (`force-with-lease`) before the
blunt one, branch diffs default to the merge base used by pull requests, and 
dragging over a diff copies exactly the selected text to your clipboard.

Inspired by the workflow that
[Lazygit](https://github.com/jesseduffield/lazygit) made popular, Ziggity is not
a port. It is written from scratch in Zig, talks directly to your existing
`git` installation (no libgit2), and deliberately makes different choices where
they improve the user experience. See
[docs/comparison.md](docs/comparison.md) for a detailed comparison.

[Website](https://ziggity.dev) · [Features](docs/features.md) ·
[Keybindings](docs/keybindings.md) · [Configuration](docs/configuration.md) ·
[Comparison with lazygit](docs/comparison.md)

## Why Ziggity?

- ⚡ 1.9 MB standalone binary
- 🚀 Starts in ~3.2 ms
- 🔄 Non-blocking Git operations
- 🖱️ First-class keyboard and mouse interaction
- 🤖 Optional AI commit messages and pull request descriptions, using the model or subscription you already have
- 🐙 Uses your existing `git` installation
- 🧩 No libgit2 dependency
- ⚙️ Written entirely in Zig
- 💻 Runs on macOS, Linux, and Windows
- 📱 Even on Android, i