KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

gitti

★ 48 Open GitHub ↗

A lightweight terminal UI for git operations developed in golang

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A fast, lightweight terminal UI for Git operations that keeps you in your flow.

# Gitti

A fast, lightweight terminal UI for Git operations that keeps you in your flow.

![Demo](https://raw.githubusercontent.com/gohyuhan/gitti/main/assets/demo.gif)

## Requirements

- **Git 2.36+**
- **xclip** or **xsel** (for linux only)

## Description

Gitti is a visual Git client built for developers who live in the terminal. It provides an intuitive TUI (Terminal User Interface) for common Git operations without the overhead of traditional GUI applications or the verbosity of CLI commands.

## Why Gitti?

Gitti is built for terminal-focused developers who need visual Git operations without breaking their flow. Traditional GUI clients like GitHub Desktop offer great interfaces but consume significant RAM and force context switching that disrupts your coding rhythm. Pure CLI commands are powerful but lack visual context for reviewing changes and managing branches. Born from personal need while working in Neovim, Gitti bridges this gap by bringing an intuitive, lightweight TUI directly into your terminal, no window management, no context switching, just seamless Git operations with visual clarity. Plus, it's universal with built-in support for English, Japanese, Simplified & Traditional Chinese.

## Features

- 🌳 **Branch Management** - View, switch, and manage branches with ease
- 📝 **Interactive Staging** - Visually select and stage files, including line-level staging and unstaging
- 🔍 **Diff Viewer** - Review changes with syntax-aware diff display
- 💬 **Commit Interface** - Write commits with a dedicated UI
- 🚀 **Push/Pull Operations** - Manage remote operations seamlessly
- 🔄 **Merge** - Merge branches with configurable fast-forward options and signing support
- 💿 **Changes Stash Operations** - Manage stash operations seamlessly
- 🔀 **Conflict Resolution** - Detect and resolve merge conflicts with interactive options
- 🍒 **Cherry-pick** - Apply individual commits across branches
- ↩️ **Git Reset** - Hard, soft, and mixed reset support
- 🔙 **Revert Commit** - Revert commits safely
- 🏷️ **Tag Management** - Create and manage Git tags
- 🌐 **Remote Management** - View and manage remotes
- 📡 **Manual Fetch** - Trigger fetch all on demand
- 🔏 **Commit & Tag Signing** - GPG and SSH signing support
- 📊 **Commit Log & Branch Graph** - Visualize commit history with branching graph
- 🔎 **Reflog** - Browse and restore from Git reference logs
- 🫵 **Git Blame** - View line-by-line blame with commit author and message
- 🔦 **List Filtering** - Filter the branch, tag, remote, worktree, file, commit log, reflog, and stash lists with `F`
- 🕹️ **Interactive Rebase** - Drop, reword, fixup, and squash commits interactively
- 📦 **Basic Submodule Support** - Work with Git submodules in your repositories
- 🌲 **Worktree Management** - Add, switch, remove, prune, and lock/unlock Git worktrees
- 🪵 **Logging & Log Export** - Built-in logging panel with log export capability
- 🌍 **Multi-language Support** - English, Japanese, 简体中文, 繁體中文
- ⚡ **Real-time Updates** - File system monitoring for instant status updates
- ⌨️ **Keyboard-driven** - Efficient navigation without touching the mouse
- 🖱️ **Mouse Support** - Optional click to focus a panel or select a list item

## Installation

### Linux

```bash
curl --proto "=https" -sSfL https://github.com/gohyuhan/gitti/releases/latest/download/install.sh | bash
```

### macOS (curl or homebrew)

```bash
curl --proto "=https" -sSfL https://github.com/gohyuhan/gitti/releases/latest/download/install.sh | bash

# via homebrew
# Add the tap (once)
brew tap gohyuhan/gitti

# Install latest
brew update && brew install gitti
```

### Windows (PowerShell or scoop)

```powershell
powershell -c "irm https://github.com/gohyuhan/gitti/releases/latest/download/install.ps1 | iex"

# via scoop
# Add the bucket (once)
scoop bucket add gitti https://github.com/gohyuhan/scoop-gitti

# Install latest
scoop update; scoop install gitti
```

### Go Install

If you have Go installed, you can install Gitti directly:

```bash
go install github.com/gohyuhan/gitti@latest
```

## Uninstall & Cleanup

### macOS (Homebrew)

```bash
# 1. Uninstall + remove ALL versions
brew uninstall --force gitti

# 2. Remove the tap
brew untap gohyuhan/gitti

# 3. Delete the binary directly (in case it's not a symlink or brew missed it)
rm -f /opt/homebrew/bin/gitti
rm -f /usr/local/bin/gitti

# 4. Delete the entire Cellar folder for gitti (old kegs)
rm -rf /opt/homebrew/Cellar/gitti
rm -rf /usr/local/Cellar/gitti

# 5. Delete any leftover symlinks
rm -rf /opt/homebrew/opt/gitti
rm -rf /usr/local/opt/gitti

# 6. Delete all cached downloads for gitti
rm -rf ~/Library/Caches/Homebrew/gitti*
rm -rf ~/Library/Caches/Homebrew/downloads/*gitti*
```

### Windows (Scoop)

```powershell
# 1. Uninstall the app (all versions)
scoop uninstall gitti 2>$null

# 2. Remove the bucket
scoop bucket rm gitti 2>$null

# 3. Delete the app folder completely (including shims + persist)
rm -r -force "$env:USERPROFILE\scoop\apps\gitti" 2>$null

# 4. Delete the bucket clone
rm -r -force "$env:USERPROFILE\scoop\buckets\gitti" 2>$null

# 5. Delete all cached installers for gitti
scoop cache rm "gitti*" 2>$null
```

### Manual Installation (curl / powershell)

#### macOS / Linux

```bash
# Remove binary (if installed via curl)
sudo rm -f /usr/local/bin/gitti
```

#### Windows

```powershell
# Remove binary and directory
Remove-Item -Path "$env:LOCALAPPDATA\gitti" -Recurse -Force
```

### Configuration Cleanup

To completely remove Gitti's configuration files:

#### macOS

```bash
rm -rf "$HOME/Library/Application Support/gitti"
```

#### Linux

```bash
rm -rf "$HOME/.config/gitti"
```

#### Windows

```powershell
Remove-Item -Path "$env:APPDATA\gitti" -Recurse -Force
```

## Quick Start

Launch Gitti in any Git repository:

```bash
gitti
```

### Configuration

Set your preferred language:

```bash
gitti --language en    # English
gitti --language ja    # Japanese
gitti --language zh-hans  # Simplified Chinese
gitti --language zh-hant  # Traditional Chinese
```

Configure default branch for new repositories:

```bash
# For gitti only
gitti --init-dbranch main

# For global Git configuration that will be set to gitti and system git
gitti --init-dbranch main --global
```

## Changelog

### [v0.9.0]

- feature: list filtering with `F` for the branch, tag, remote, worktree, file, commit log, reflog, and stash lists
- feature: mouse click to focus a panel or select a list item
- other: split keybindings into their own files
- other: update release CI for the Node.js 20 actions deprecation

### [v0.8.0]

- feature: worktree management
  - list and switch worktrees from within the app
  - add new worktree (optionally from a branch)
  - remove and prune worktrees
  - lock/unlock worktrees with lock reason support
- feature: keybinding to open the current repo with a user-defined editor
- other: block bare git repos with clearer messaging on what is supported

### [v0.7.2]

- fix: fix pop up state not reset under the following condition:
  - after a successful git ops that require signing
  - suspend not configured

### [v0.7.1]

- fix: fix line overflow when rebase results in conflict with following condition:
  - commit signing enabled
  - suspend not configured

### [v0.7.0]

- feature: git blame — view line-by-line blame with commit info
- feature: interactive rebase
  - drop commit
  - reword commit
  - fixup/squash commit
- optimize: mouse interaction improvements
- optimize: rendering interaction improvements

### [v0.6.3]

- fix: rework v0.6.2 UI freeze fix with better handling to prevent UX degradation
- other: bump dep package version and utilize latest api

### [v0.6.2]

- fix: update commit log parsing seperator to prevent weird parse behaviour
- fix: fix UI freeze when git ops that require signing returns error

### [v0.6.1]

- fix: fix rebase incorrect git command flag and arguments for local branch rebase

### [v0.6.0]

- feature: reflog UI component with related functionality
- feature: rebase current branch onto any other branch (not limited to upstream)
- feature: create a local branch from a remote by selecting from the remote branch list (QOL)
- feature: merge branch with configurable fast-forward behavior via `--ff-merge` config option
- other: upgraded bubbletea, bubbles, and lipgloss dependencies from v2 pre-release to v2 stable

### [v0.5.0]

- optimize: revamp of instructions/keybindings popup
- feature: manual fetch all
- feature: remote management
- feature: revert commit
- feature: tag management
- feature: support commit and tag signing (GPG/SSH)

### [v0.4.1]

- hotfix: prevent deadlock in main thread by moving checking into goroutine when user navigate a list quickly which cause detail panel to constantly cancel and fetch relevant content

### [v0.4.0]

- feature: introduce copy and paste for input field
- feature: add config for max count retrieval for commit logs (--max-commit-count)
- feature: universal `--skip`
- feature: build commit-graph goroutine function so large repo benefit from it to speed up git log retrieval
- feature: add logging component panel and logging and log exporting feature
- feature: reposition line staging mode into line editing in general and allow line discard
- optimize: optimize branch,file,commit log and stash panel cursor reposition to retain selection

### [v0.3.1]

- fix: fix for cherry pick selection reinit after applying cherry pick git operation is executed

### [v0.3.0]

- fix: scrolling problem that will cause UI fix due to overscrolling by adding throttle for scrolling
- fix: unnecessary split when the files indexstate and worktree is both “?”
- fix: -/+ key conflict during typing mode by restricting -/+ key for left panel adjustments when in typing mode
- feature: introduce keybinding for universal `--continue` and universal `--abort` for git operation that accept this flag. e.g, cherry pick, merge etc
- feature: introduce individual line staging and unstaging
- feature: introduce cherry-pick

### [v0.2.1]

- Address a fix for CLRF (^M) that break detail view panel UI layout

### [v0.2.0]

- Added a new component to display a summary list of commits with a commit branching graph
- The details component now shows comprehensive information, including specific changes and diffs for each commit
- Implemented Hard, Soft, and Mixed reset functionality. New keybindings: `R` (reset latest commit) and `r` (reset selected commit)
- Added item counters to all popup lists for better visibility
- Introduced real-time adjustment of the left panel width using the `-` and `+` keys
- Added support for creating/pulling from remote branches and deleting local branches. New keybinding: `d` (delete local branch)
- Implemented a split view in the detail component for staged and unstaged changes. New keybindings: `[` and `]` (navigate between panels)
- Added an 'edit' feature to open specific files directly in the terminal or external IDE based on configuration. New keybinding: `e` (edit file)
- New feature to pull and create branch based of a remote branch

### [v0.1.3]

- hotfix: irrelevant git events trigger update and add control for git fetch

### [v0.1.2]

- hotfix: list counter not counting

### [v0.1.1]

- Context-based Process Management: Refactored Git operations to use context.Context for process cancellation and termination instead of manual process killing, providing cleaner and more reliable subprocess management
- Detail Panel Performance Optimization: Optimized the detail component panel info fetching to prevent UI blocking by implementing non-blocking async data retrieval, with additional optimizations to prevent unnecessary UI re-rendering
- Renamed/Copied File Handling: Added proper handling for renamed files (index state "R") in stage, unstage, and discard operations, and improved overall handling of copied and renamed files
- Git Stash Operations: Added output viewport and confirmation pop-ups for Git stash operations, with width adjustments for various TUI pop-ups
- Git Conflict Resolution: Introduced Git conflict detection and resolve options with enhanced thread-safety for streaming Git output to the UI. A new Keybinding for conflict resolution is added: `r` (resolve)
- Commit Output Control: Introduced InitialCommitStarted flag to control commit output viewport visibility and added viewport Y-offset adjustments for improved UI positioning

### [v0.1.0]

- Initial release in development
- Core TUI implementation
- Branch management and switching
- Interactive file staging
- Diff viewer
- Commit, pull and push operations
- Changes stash operation
- Multi-language support (en, ja, zh-hans, zh-hant)
- Real-time file system monitoring
- Configuration management
- Basic submodule support

## License

MIT License - see [LICENSE](LICENSE) file for details

## Acknowledgments

Built with:

- [Bubble Tea](https://github.com/charmbracelet/bubbletea) - TUI framework
- [Lip Gloss](https://github.com/charmbracelet/lipgloss) - Terminal styling
- [Bubbles](https://github.com/charmbracelet/bubbles) - TUI components

---

**Made with ❤️ for terminal enthusiasts who refuse to break their flow**

gitti

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README