README
¶
Gitty
Full-featured TUI git client with smart commit suggestions. Stage files, commit with AI-style suggestions, manage branches, rebase, stash, and monitor CI/CD — all from the terminal. Built with Go and Bubble Tea.
Quick Install
Recommended (installs to ~/.local/bin):
curl -fsSL https://raw.githubusercontent.com/LFroesch/gitty/main/install.sh | bash
Or download a binary from GitHub Releases.
Or install with Go:
go install github.com/LFroesch/gitty@latest
Or build from source:
make install
Command:
gitty
Install
go install github.com/LFroesch/gitty@latest
Or build from source:
make install
Usage
cd your-repo
gitty
Tabs
1. Workspace
File staging with live diff preview.
| Key | Action |
|---|---|
space |
Stage/unstage file |
a |
Stage all |
R |
Reset (unstage all) |
v |
Toggle diff preview |
d |
View full diff |
Conflict mode (auto-activates): o ours, t theirs, b both, c continue merge.
2. Commit
Smart suggestions + custom input.
| Key | Action |
|---|---|
1-9 |
Commit with numbered suggestion |
enter/c |
Type custom message |
space |
Commit with selected suggestion |
Suggestions are generated from diff analysis — detects keywords, function names, variables, comments, and classifies changes as feat/fix/refactor/etc.
3. Branches
Create, switch, delete, merge, compare.
| Key | Action |
|---|---|
enter |
Switch to branch |
n |
Create new branch |
d |
Delete branch |
m |
Merge into current |
c |
Compare with main |
f |
Fetch remote |
p |
Prune stale remotes |
4. Tools
Advanced operations submenu.
| Tool | What it does |
|---|---|
| Undo/Revert | Soft/mixed/hard reset, reflog |
| Interactive Rebase | Squash, reword, drop, fixup |
| History | Last 20 commits, hash copy |
| Remote | Push, pull, fetch |
Also: stash (list/push/pop/apply/drop), tags (list/create/delete/push), cherry-pick, revert, clean, git hooks.
5. GitHub
CI/CD workflow status via gh CLI.
| Key | Action |
|---|---|
enter |
View run logs |
R |
Rerun workflow |
r |
Refresh |
Commit Suggestion Engine
Parses diffs and generates conventional commit messages:
[1] feat(auth): add validation to userInput
[2] fix(auth): fix error handling in processPayment
[3] refactor(api): optimize database query performance
Detects: keywords (bug, fix, optimize, cache), function names (Go/JS/TS/Python/Java/C#), variable names, code comments, change patterns.
Git Hooks
Press h to install hooks, H to remove, i to check status:
- Conventional commit message validation
- No large files
- Detect secrets
License
Documentation
¶
There is no documentation for this package.
Source Files
Directories