gohyuhan/gitti
gohyuhan/gitti has 51 GitHub stars and 3 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-15 17:22 UTC. Last push 2026-10-31.
What you can do
- ๐ณ Branch Management - View, switch, rename, and manage branches with ease
- ๐ Interactive Staging - Visually select and stage files, including line-level staging and unstaging
- ๐ซ Ignore Untracked Files - Press i in the files panel to add an exact rule to the nearest .gitignore
- ๐ Diff Viewer - Review changes with syntax-aware diff display
Measured star growth
- in 24h
- 0
- in 7 days
- 0
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
A lightweight terminal UI for git operations developed in golang
Developer ToolsREADME.md
Original
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.

Requirements
- Git 2.36+
- On Linux, xclip, xsel, or wl-clipboard for clipboard support
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, rename, and manage branches with ease
- ๐ Interactive Staging - Visually select and stage files, including line-level staging and unstaging
- ๐ซ Ignore Untracked Files - Press
iin the files panel to add an exact rule to the nearest.gitignore - ๐ 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; press Enter to drill down into touched files, view individual file diffs, checkout (
c), or discard (d) changes - ๐ 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, commit files, reflog, and stash lists with
F - ๐ Copy Popup - Press
yto copy details from a selected branch, tag, remote, worktree, file, commit, reflog entry, or stash - ๐น๏ธ 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
curl --proto "=https" -sSfL https://github.com/gohyuhan/gitti/releases/latest/download/install.sh | bash
macOS (curl or homebrew)
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 -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:
go install github.com/gohyuhan/gitti@latest
Uninstall & Cleanup
macOS (Homebrew)
# 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)
# 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
# Remove binary (if installed via curl)
sudo rm -f /usr/local/bin/gitti
Windows
# Remove binary and directory
Remove-Item -Path "$env:LOCALAPPDATA\gitti" -Recurse -Force
Configuration Cleanup
To completely remove Gitti's configuration files:
macOS
rm -rf "$HOME/Library/Application Support/gitti"
Linux
rm -rf "$HOME/.config/gitti"
Windows
Remove-Item -Path "$env:APPDATA\gitti" -Recurse -Force
Quick Start
Launch Gitti in any Git repository:
gitti
Configuration
Set your preferred language:
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:
# 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
Show the version or update Gitti:
gitti --version # Print the installed version
gitti --update # Update to the latest version
gitti --auto-update false # Turn off the check for a new version on launch (default: true)
Choose the editor that Gitti opens files and the repo with (pick from a numbered list):
gitti --editor
Commit log and reflog:
gitti --max-commit-log-count 5000 # Max commit log entries to load (default: 2500)
gitti --max-reflog-count 5000 # Max reflog entries to load (default: 2500)
gitti --allow-commit-graph-write false # Turn off commit-graph writes that speed up the log on large repos (default: true)
Log panel:
gitti --max-log-count 500 # Max Gitti log entries to keep (default: 300)
gitti --show-x-log 5 # Log entries shown in the log panel (default: 3, must not exceed --max-log-count)
Merge and signing:
gitti --ff-merge true # Fast-forward merge, no merge commit (default: false)
gitti --override-signing-ui-suspend true # Do not suspend the UI for signing (default: false)
Only turn on --override-signing-ui-suspend if signing needs no passphrase or another tool enters it for you.
Each flag above runs, then exits without opening the TUI. Pass one flag per command. The only pair is --init-dbranch with --global.
Changelog
[v0.10.0]
- feature: filter remote branch choices by typing (#82)
- refactor: use one text input for list filters beside the list counter (#83)
- feature: rename a local branch with
ein the branch panel - fix: file paths with spaces or non-ASCII characters now work in the files panel
- feature: copy selected row details to the clipboard with
yin all eight list panels - feature: ignore an untracked file with
iin the files panel, using the nearest.gitignore
[v0.9.0]
- feature: list filtering with
Ffor 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-mergeconfig 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-log-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
--continueand universal--abortfor 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) andr(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 file for details
Acknowledgments
Built with:
- Bubble Tea - TUI framework
- Lip Gloss - Terminal styling
- Bubbles - TUI components
Made with โค๏ธ for terminal enthusiasts who refuse to break their flow